CIM
The Common Information Model (CIM) represents a common logical view of EMS public data. The CIM definition consists of a comprehensive information model. This information model is largely independent of any specific technological implementation methods.
CimVersion
This is the CIM version number assigned to this UML model file. The Version naming convention is to use the last major revision file name followed by the date of the last revision 9e.g., cimu08b_001212).
Version
LastUpdate
Core
Contains the core PowerSystemResource and ConductingEquipment entities shared by all applications plus common collections of those entities. Not all applications require all the Core entities.
Bay
A collection of power system resources (within a given substation) including conducting equipment, protection relays, measurements, and telemetry.
bayEnergyMeasFlag
Indicates the presence/absence of kWh/kvarh measurements.
bayPowerMeasFlag
Indicates the presence/absence of MW/Mvar measurements.
breakerConfiguration
busBarConfiguration
ConductingEquipment
The parts of the power system that are designed to carry current or that are conductively connected therewith. ConductingEquipment is contained within an EquipmentContainer that may be a Substation, or a VoltageLevel or a Bay within a Substation.
phases
Describes the phases carried by a conducting equipment. Possible values { ABCN , ABC, ABN, ACN, BCN, AB, AC, BC, AN, BN, CN, A, B, C, N }.
ControlHouseEquipment
Equipment in a substation control house. Covers things such as fire alarms, ambient temperature, door alarms, and spares.
controlHouseEquipType
PowerSystemResource
A power system resource can be an item of equipment such as a Switch, an EquipmentContainer containing many individual items of equipment such as aSubstation, or an organisational entity such as Company or SubControlArea. This provides for the nesting of collections of PowerSystemResources within other PowerSystemResources. For example, a Switch could be a member of a Substation and a Substation could be a member of a division of a Company.
Substation
A collection of equipment for purposes other than generation or utilization, through which electric energy in bulk is passed for the purposes of switching or modifying its characteristics.
Terminal
An electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called 'connectivity nodes'.
SubControlArea
An area defined for the purpose of tracking interchange with surrounding areas via tie points; may or may not serve as a control area.
CurveSchedule
Relationship between an independent variable (X-axis) and one or two dependent variables (Y1-axis and Y2-axis). Curves can also serve as schedules.
curveStyle
rampMethod
The deltaY versus deltaX units of measure. Applies to all ramps.
rampStartMethod
The method of applying the ramp: 0 at start point, 50% at start point, 100% at start point. For methods 2 and 3, the ramp begins ahead of the start point on the X-axis. NOTE: For storage, all ramps are to be normalized to Method '1' (0 at start point).
rampUnits
The deltaY versus deltaX units of measure. Same for 'two' Y values.
xAxisType
xAxisUnits
y1AxisUnits
y2AxisUnits
yAxisType
CurveSchedData
Data point values for defining a curve or schedule
rampData
The data value of the rate-of-change of the Y-axis variable with respect to the X-axis variable
rampDataValue
The data value of the rate-of-change of the Y-axis variable with respect to the X-axis variable ( 0 = instantaneous change)
xAxisData
The data value of the X-axis variable, depending on the X-axis units
y1AxisData
The data value of the first Y-axis variable, depending on the Y-axis units
y2AxisData
The data value of the second Y-axis variable (if present), depending on the Y-axis units
CurveSchedFormula
Mathematical formula for defining a curve or schedule segment
xLowerBound
The minimum value of the X-variable for the range of the function
xUpperBound
The maximum value of the X-variable for the range of the function
yFunction
Mathematical formula for the Y-axis variable with numerical constants
BaseVoltage
Collection of BaseVoltages which is used to verify that the BusbarSection.BaseVoltage and other voltage attributes in the CIM are given a value existing in the collection.
nominalVoltage
BasePower
The BasePower class defines the base power and base voltages that are used in the per unit calculations.
basePower
VoltageLevel
A collection of equipment at one common system voltage forming a switchgear. The equipment typically consist of breakers, busbars, instrumentation, control, regulationand protection devices as well as assemblies of all these.
highVoltageLimit
lowVoltageLimit
Naming
This is a root class to provide common naming attributes for all classes needing naming attributes
aliasName
Free text name of the object or instance.
description
name
Unique name among objects owned by the same parent.
pathName
pathName is a concatenation of all names from each container.
Equipment
The parts of a power system that are physical devices, electronic or mechanical
Unit
Quantity being measured. The Unit.name shall be unique among all specified quantities and describe the quantity. The Unit.aliasName is meant to be used for localization.
EquipmentContainer
A modeling construct to provide a root class for all Equipment classes
PSRType
Classifying instances of the same class, e.g. overhead and underground ACLineSegments. This classification mechanism is intended to provide flexibility outside the scope of this standard, i.e. provide customisation that is non standard.
Domain
The domain package is a data dictionary of quantities and units that define datatypes for attributes (properties) that may be used by any class in any other package.This package contains the definition of primitive datatypes, including units of measure and permissible values. Each datatype contains a value attribute and an optional unit of measure, which is specified as a static variable initialized to the textual description of the unit of measure. The value of the 'units' string may be country or customer specific. Typical values are given. Permissible values for enumerations are listed in the documentation for the attribute using UML constraint syntax inside curly braces. Lengths of variable strings are listed in the descriptive text where required.
AbsoluteDateTime
Date and time as 'yyyy-mm-ddThh:mm:ss', which conforms with ISO 8601 using the extended form and UTC rather than local time zones.
value
Date and time as 'yyyy-mm-ddThh:mm:ss', which conforms with ISO 8601 using the extended form and any of the zone options.
units
ActivePower
Product of RMS value of the voltage and the RMS value of the in-phase component of the current (Megawatt)
ApparentPower
Product of the RMS value of the voltage and the RMS value of the current (MegaVoltAmperes)
BoilerControlMode
following
coordinated
Classification
1..n, with 1 the most detailed, highest priority, etc.
ControlMode
CostPerEnergyUnit
Cost, in units of currency, per megawatt hour of electricity generated
CostPerHeatUnit
Cost, in units of currency, per million Btus of heat generated
CostPerHour
Cost, in units of currency, per hour of elapsed time
Counter
Measurement of quantity (must be greater than or equal to zero)
Value must be greater than or equal to 0
CurrentFlow
Current flow in Amps (positive flow is out of the ConductingEquipment into the ConnectivityNode)
Damping
Per-unit megawatt variation with per-unit frequency referenced on the system MVA base. Typical values in range 1.0 - 2.0
AngleDegrees
Emission
Quantity of emission per fuel heat content
EnergyAsMWh
ExcitingCurrent
The exciting current on open-circuit test, expressed as a percentage of rated current, at nominal voltage
Exponent
Fraction
Fractional amount. Sum of all fractions of the same quantity should be 1.0
FreqBiasFactor
Frequency
HeatPerHour
Heat generated, in millions of Btus, per hour of elapsed time
Hours
Inductance
Inertia
Megawatt-seconds per megavolt-ampere rating of the unit referenced on the system MVA base. Typical values in range 3.0 - 5.0
Load
LoadLoss
The loss on short-circuit test at rated current
LongLength
Long unit of length (e.g. mile; kilometer)
Money
NoLoadLoss
The loss on open-circuit test at nominal voltage
OperatingMode
ParticipationFactor
Generating unit economic participation factor
PenaltyFactor
Defined as: 1 / ( 1 - Incremental Transmission Loss); with the Incremental Transmission Loss expressed as a plus or minus value. The typical range of penalty factors is (0.9 to 1.1).
PerCent
AngleRadians
PowerFactor
PowerROCPerMin
PowerROCPerSec
PowerVersusFrequency
Per unit real power variation versus per unit frequency variation
PowerVersusVoltage
Per unit real power variation versus per unit voltage variation
Pressure
Pressure given in terms of pound-force per square inch
Priority
Defines levels of priority as a numeric value with zero being the highest priority level.
Per Unit - a positive or negative value referred to a defined base. Values typically range from -10 to +10.
PUkVPerMVAr
RateOfChange
Rate of change of dimensionless variable
Ratio
Reactance
Reactance (imaginary part of impedance), in ohms, at rated frequency
ReactivePower
Product of RMS value of the voltage and the RMS value of the quadrature component of the current (Megavoltamperes Reactive)
Reference
Resistance
Resistance (real part of impedance), in ohms
Seconds
ShortLength
SwitchState
open
close
TapStep
Transformer tap step position. Positions are always numbered sequentially starting with '1' at the lowest tap position and progressing through the highest tap position.
Temperature
Value of temperature in TemperatureUnits
TemperatureUnits
Units for temperature measurement {celsius , fahrenheit}
celsius
fahrenheit
WindingType
The winding type, i.e., Primary, Secondary, Tertiary, Quaternary.
primary
secondary
tertiary
quaternary
TerminalCount
Maximum number of terminals for a conducting equipment.
TerminalType
A designation of the function of a terminal on its associated conducting equipment.
Voltage
Volume
Reservoir water volume, given in millions of cubic meters
WaterLevel
Reservoir water level referred to a given datum such as mean sea level, in meters
WindingConnection
D | Y | Z for Delta | Wye | ZigZag winding connections
SeasonName
winter
spring
summer
fall
DayTypeName
weekday
weekend
holiday
PhaseCode
BreakerConfiguration
singleBreaker
breakerAndAHalf
doubleBreaker
noBreaker
BusbarConfiguration
singleBus
doubleBus
mainWithTransfer
ringBus
ClearanceTagType
Type of ClearanceTag. Could indicate the type of work to be performed and/or the type of supervisory control.
CompanyType
pool
municipal
private
ControlHouseEquipmentType
CoolantType
air
hydrogenGas
water
CurveStyle
constantYValue
straightLineYValues
rampYValue
formula
EmissionType
sulfurDioxide
carbonDioxide
nitrogenOxide
hydrogenSulfide
chlorine
carbonDisulfide
EmissionValueSource
measured
calculated
FuelType
coal
oil
gas
PenstockType
RampMethod
The deltaY versus deltaX units of measure.
yUnitsPerMinute
rampCompletionInMinutes
RampStartMethod
zero
fiftyPerCent
oneHundredPerCent
RampUnits
MWPerMinute
rampCompletionInMin
SpillwayGateType
SurgeTankCode
Type (or absence) of surge tank that is associated with the hydro power plant.
TransformerCoolingType
TurbineType
francis
pelton
kaplan
XAxisType
The type of independent variable on the x axis.
absoluteTime
normalizedDailyTime
anyRealValue
XAxisUnits
normalizedTime
YAxisType
singleYValue
twoYValues
Y1AxisUnits
MVAr
integer
unitOfCurrencyPerHour
Y2AxisUnits
EnumeratedType
An enumerated type for attributes whose domain is a finite set of values. The legal values are normally listed in the attribute description, using the UML constraint syntax { value1, value2, ...valueN}.
HydroPlantType
The type of hydro power plant, e.g.: Run-of-River, Pumped Storage, Major Storage, Minor Storage.
runOfRiver
pumpedStorage
majorStorage
minorStorage
Admittance
Impedance
Conductance
Factor by which voltage must be multiplied to give corresponding power lost from a circuit. Real part of admittance.
Susceptance
NumericType
INT_TYPE
UNSIGNED_TYPE
DOUBLE_TYPE
COMPLEX_TYPE
DATE_TIME_TYPE
ULONG_LONG_TYPE
SHORT_TYPE
LONG_LONG_TYPE
LONG_DOUBLE_TYPE
BOOLEAN_TYPE
Numeric
ULong
Double
Complex
DateTime
ULongLong
Short
LongLong
LongDouble
Boolean
TransformerType
fix
voltageControl
phaseControl
voltageAndPhaseControl
CompensatorType
shunt
series
Validity
GOOD
The value is marked good if no abnormal condition of the acquisition function or the information source is detected.
QUESTIONABLE
The value is marked questionable if a supervision function detects an abnormal behaviour, however the value could still be valid. The client is responsible for determining whether or not values marked 'questionable' should be used.
INVALID
The value is marked invalid when a supervision function recognises abnormal conditions of the acquisition function or the information source (missing or non-operating updating devices). The value is not defined under this condition. The mark invalid is used to indicate to the client that the value may be incorrect and shall not be used.
Source
Source gives information related to the origin of a value. The value may be acquired from the process, defaulted or substituted.
PROCESS
The value is provided by input from the process I/O or being calculated from some function.
DEFAULTED
SUBSTITUTED
The value is provided by input of an operator or by an automatic source.
RemoteUnitType
RTU
SubstationControlSystem
ControlCenter
SynchronousMachineOperatingMode
generator
condenser
SynchronousMachineType
generator_or_condenser
TransformerControlMode
Control modes for a transformer, i.e., Off, Local, Volt, MVAr
off
local
volt
mVAr
GeneratorOperatingMode
Operating mode for secondary generator control, e.g.: Unavailable, Manual, Fixed, Load Frequency Control, AGC, EDC, RPN, MRN, or REG
Off
Manual
Fixed
LFC
AGC
EDC
RPN
MRN
REG
GeneratorControlMode
Unit control modes, i.e., Setpoint (S) or Pulse (P).
setpoint
pulse
CompositeSwitchType
An alphanumeric code that can be used as a reference to extar information such as the description of the interlocking scheme if any
GeneratorControlSource
The source of controls for a generating unit, i.e., Unavailable, Off-AGC, On-AGC, Plant Control
Unavailable
Off-AGC
On-AGC
PlantControl
TimeStamp
This diagram shows all Integer data types.This diagram shows all Float data types.This diagram shows all String data types.This diagram shows all special data types.This diagram shows all Enumeration data types.
Generation
This package contains packages that have information for Unit Commitment and Economic Dispatch of Hydro and Thermal Generating Units, Load Forecasting, Automatic Generation Control, and Unit Modeling for Dynamic Training Simulator.
Production
The production package is responsible for classes which describe various kinds of generators. These classes also provide production costing information which is used to economically allocate demand among committed units and calculate reserve quantities.
ThermalGeneratingUnit
A generating unit whose prime mover could be a steam turbine, combustion turbine, or diesel engine.
oMCost
Operating and maintenance cost for the thermal unit
TargetLevelSchedule
Reservoir water level targets from advanced studies or 'rule curves'. Typically in one hour increments for up to 10 days
highLevelLimit
High target level limit, above which the reservoir operation will be penalized
lowLevelLimit
Low target level limit, below which the reservoir operation will be penalized
TailbayLossCurve
Relationship between tailbay head loss (in meters on the Y-axis) and the total discharge into the power station's tailbay (in m3/sec on the X-axis) . There could be more than one curve depending on the level of the tailbay reservoir or river level
SteamSendoutSchedule
The cogeneration plant's steam sendout schedule in klb/hour versus time
StartupModel
Unit start up characteristics depending on how long the unit has been off line
fixedMaintCost
hotStandbyHeat
The amount of heat input per hour required for hot standby operation
incrementalMaintCost
minimumDownTime
The minimum number of hours the unit must be down before restart
minimumRunTime
The minimum number of hours the unit must be operating before being allowed to shut down
riskFactorCost
The opportunity cost associated with the return in dollars. This represents the restart's 'share' of the unit depreciation and risk of an event which would damage the unit.
startupCost
startupDate
The date and time of the most recent generating unit startup
startupPriority
Startup priority within control area where lower numbers indicate higher priorities. More than one unit in an area may be assigned the same priority.
stbyAuxPowerMW
The unit's auxiliary power consumption to maintain standby mode
StartRampCurve
Rate in gross MW/minute (Y-axis) at which a unit can be loaded versus the number of hours (X-axis) the unit was off line
hotStandbyRamp
The startup ramp rate in gross MW/minute for a unit that is on hot standby
StartMainFuelCurve
The quantity of main fuel (Y-axis) used to restart and repay the auxiliary power consumed versus the number of hours (X-axis) the unit was off line
mainFuelType
StartIgnFuelCurve
The quantity of ignition fuel (Y-axis) used to restart and repay the auxiliary power consumed versus the number of hours (X-axis) the unit was off line
ignitionFuelType
ShutdownCurve
Relationship between the rate in gross MW/minute (Y-axis) at which a unit should be shutdown and its present gross MW output (X-axis)
shutdownCost
shutdownDate
The date and time of the most recent generating unit shutdown
Reservoir
A water storage facility within a hydro system, including: ponds, lakes, lagoons, and rivers. The storage is usually behind some type of dam.
activeStorageCapacity
Storage volume (in Mm3) between the full supply level and the normal minimum operating level
energyStorageRating
The reservoir's energy storage rating in MWh for given head conditions
fullSupplyLevel
Full supply level, above which water will spill. This can be the spillway crest level or the top of closed gates.
grossCapacity
normalMinOperateLevel
Normal minimum operating level below which the penstocks will draw air
riverOutletWorks
River outlet works for riparian right releases or other purposes
spillTravelDelay
The spillway water travel delay to the next downstream reservoir
spillwayCapacity
The flow capacity of the spillway in cubic meters per second
spillwayCrestLength
The length of the spillway crest in meters
spillwayCrestLevel
Spillway crest level above which water will spill
spillWayGateType
Type of spillway gate, including parameters
PenstockLossCurve
Relationship between penstock head loss (in meters) and total discharge through the penstock (in cubic meters per second). One or more turbines may be connected to the same penstock.
LevelVsVolumeCurve
Relationship between reservoir volume in millions of cubic meters and reservoir level in meters
InflowForecast
Natural water inflow to a reservoir, usually forecasted from predicted rain and snowmelt. Typically in one hour increments for up to 10 days. The forecast is given in average cubic meters per second over the time increment.
IncrementalHeatRateCurve
Relationship between unit incremental heat rate in (delta MBtu/hour) per (delta MW )and unit output in MW. The IHR curve represents the slope of the HeatInputCurve. Note that the 'incremental heat rate' and the 'heat rate' have the same engineering units, i.e., MBtu/MWh.
netGrossMWFlag
Flag is set to YES when output is expressed in net MW
HydroPumpOpSchedule
The hydro pump's Operator-approved current operating schedule (or plan), typically produced with the aid of unit commitment type analyses.The unit's operating schedule status is typically given as: (0=unavailable) (1=avilable to startup or shutdown) (2=must pump)
HydroPump
A synchronous motor-driven pump, typically associated with a pumped storage plant
pumpDischAtMaxHead
The pumping discharge (m3/sec) under maximum head conditions, usually at full gate
pumpDischAtMinHead
The pumping discharge (m3/sec) under minimum head conditions, usually at full gate
pumpPowerAtMaxHead
The pumping power (MW) under maximum head conditions, usually at full gate
pumpPowerAtMinHead
The pumping power (MW) under minimum head conditions, usually at full gate.
HydroPowerPlant
A hydro power station which can generate or pump. When generating, the generator turbines receive there water from an upper reservoir. When pumping, the pumps receive their water from a lower reservoir.
dischargeTravelDelay
Water travel delay from tailbay to next downstream hydro power station
hydroPlantType
penstockType
Type and configuration of hydro plant penstock(s)
plantDischargeCapacity
Total plant discharge capacity in cubic meters per second
plantMWGenRating
The hydro plant's generating rating in MW for rated head conditions
plantMWPumpRating
The hydro plant's pumping rating in MW for rated head conditions
plantRatedHead
surgeTankCode
A code describing the type (or absence) of surge tank that is associated with the hydro power plant
surgeTankCrestLevel
The level at which the surge tank spills
HydroGeneratingUnit
A generating unit whose prime mover is a hydraulic turbine (e.g., Francis, Pelton, Kaplan)
hydroUnitWaterCost
The equivalent cost of water that drives the hydro turbine, expressed as (dollars/hour) per (cubic meters/second)
HydroGeneratingEfficiencyCurve
Relationship between unit efficiency in percent and unit output in MW for a given net head in meters. The relationship between efficiency, discharge, head, and power output is expressed as follows: E =KP/HQWhere: (E=%) (P=MW) (H=m) (Q=m3/s) (K=constant)For example, a curve instance for a given net head could relate efficiency (Y-axis) versus MW output (X-axis) or versus discharge on the X-axis.
HeatRateCurve
Relationship between unit heat rate in MBtu/hour per MW (Y-axis) and unit output in MW (X-axis). The heat input is from all fuels.
HeatInputCurve
Relationship between unit heat input in MBtu per hour for main fuel (Y1-axis) and supplemental fuel (Y2-axis) versus unit output in MW (X-axis). The quantity of main fuel used to sustain generation at this output level is prorated for throttling between definition points. The quantity of supplemental fuel used at this output level is fixed and not prorated.
auxPowerOffset
Power output - auxiliary power offset adjustment factor in MW
auxPowerMult
Power output - auxiliary power multiplier adjustment factor in per unit
heatInputEff
Heat input - efficiency multiplier adjustment factor in per unit
heatInputOffset
Heat input - offset adjustment factor in MBtu/hr
GrossToNetMWCurve
Relationship between the generating unit's gross MW output on the X-axis (measured at the terminals of the machine(s)) and the generating unit's net MW output on the Y-axis (based on utility-defined measurements at the power station). Station service loads, when modeled, should be treated as non-conforming bus loads. There may be more than one curve, depending on the auxiliary equipment that is in service.
GenUnitOpSchedule
The generating unit's Operator-approved current operating schedule (or plan), typically produced with the aid of unit commitment type analyses. The X-axis represents absolute time. The Y1-axis represents the status (0=off-line and unavailable: 1=available: 2=must run: 3=must run at fixed MW value: etc.). The Y2-axis represents the must run fixed MW value where required.
GenUnitOpCostCurve
Relationship between unit operating cost in $/hour (Y-axis) and unit output in MW (X-axis). The operating cost curve for thermal units is derived from heat input and fuel costs. The operating cost curve for hydro units is derived from water flow rates and equivalent water costs.
GeneratingUnit
A single or set of synchronous machines for converting mechanical power into alternating-current power. For example, individual machines within a set may be defined for scheduling purposes while a single control signal is derived for the set. In this case there would be a GeneratingUnit for each member of the set and an additional GeneratingUnit corresponding to the set.
controlDeadband
Unit control error deadband. When a unit's desired MW change is less than this deadband, then no control pulses will be sent to the unit.
controlPulseHigh
Pulse high limit which is the largest control pulse that the unit can respond to
controlPulseLow
Pulse low limit which is the smallest control pulse that the unit can respond to
controlResponseRate
Unit response rate which specifies the MW change for a control pulse of one second in the most responsive loading level of the unit.
efficiency
The efficiency of the unit in converting mechanical energy, from the prime mover, into electrical energy.
genControlMode
Select the unit control mode as Setpoint (S) or Pulse (P).
genControlSource
governorMPL
governorSCD
highControlLimit
initialMW
Default Initial MW which is used to store a powerflow result for the initial MW for this unit in this network configuration
lowControlLImit
maximumAllowableSpinningReserve
Maximum allowable spinning reserve. Spinning reserve will never be considered greater than this value regardless of the current operating point.
maximumEconomicMW
Maximum high economic MW limit, that should not exceed the maximum operating MW limit
minimumAllowableSpinningReserve
maximumOperatingMW
This is the maximum operating MW limit the dispatcher can enter for this unit
minimumEconomicMW
Low economic MW limit that must be greater than or equal to the minimum operating MW limit
minimumOperatingMW
This is the minimum operating MW limit the dispatcher can enter for this unit.
modelDetail
Detail level of the generator model data
ratedGrossMaxMW
The unit's gross rated maximum capacity (Book Value).
ratedGrossMinMW
The gross rated minimum generation level which the unit can safely operate at while delivering power to the transmission grid
ratedNetMaxMW
The net rated maximum capacity determined by subtracting the auxiliary power used to operate the internal plant machinery from the rated gross maximum capacity
startupTime
Time it takes to get the unit on-line, from the time that the prime mover mechanical power is applied
autoCntrlMarginMW
The planned unused capacity which can be used to support automatic control overruns, in MW
allocSpinResMW
The planned unused capacity (spinning reserve) which can be used to support emergency load
baseMW
For dispatchable units, this value represents the economic MW basepoint, for units that are not dispatchable, this value represents the fixed generation value. The value must be between the operating low and high limits.
dispReserveFlag
energyMinMW
fastStartFlag
fuelPriority
genOperatingMode
Operating mode for secondary control, e.g.: Off, Manual, Fixed, LFC, AGC, EDC, RPN, MRN, or REG
longPF
lowerRampRate
normalPF
penaltyFactor
raiseRampRate
shortPF
spinReserveRamp
Resource spinning reserve ramp rate in MW/min
stepChange
tieLinePF
minimumOffTime
Minimum time interval between unit shutdown and startup
FuelAllocationSchedule
The amount of fuel of a given type which is allocated for consumption over a specified period of time
fuelAllocationEndDate
The end time and date of the fuel allocation schedule
fuelAllocationStartDate
The start time and date of the fuel allocation schedule
fuelType
The type of fuel, which also indicates the corresponding measurement unit
maxFuelAllocation
The maximum amount fuel that is allocated for consumption for the scheduled time period
minFuelAllocation
The minimum amount fuel that is allocated for consumption for the scheduled time period, e.g., based on a 'take-or-pay' contract
FossilFuel
The fossil fuel consumed by the non-nuclear thermal generating units, e.g., coal, oil, gas
fossilFuelType
The type of fossil fuel, such as coal, oil, or gas.
fuelCost
The cost in terms of heat value for the given type of fuel
fuelDispatchCost
The cost of fuel used for economic dispatching which includes: fuel cost, transportation cost, and incremental maintenance cost
fuelEffFactor
The efficiency factor for the fuel (per unit) in terms of the effective MBtu absorbed
fuelHandlingCost
Handling and processing cost associated with this fuel
fuelHeatContent
The amount of heat (Btu) per weight (or volume) of the given type of fuel
fuelMixture
The amount in percent of the given type of fuel , when multiple fuels are being consumed
fuelSulfur
The fuel's fraction of pollution credit per unit of heat content (MBtu)
highMWBreakpoint
The MW output level of the unit at which the given type of fuel is switched on. This fuel (e.g., oil) is sometimes used to supplement the base fuel (e.g., coal) at high MW output levels.
lowMWBreakpoint
The MW output level of the unit at which the given type of fuel is switched off. This fuel (e.g., oil) is sometimes used to stabilize the base fuel (e.g., coal) at low MW output levels.
EmissionCurve
Relationship between the unit's emission rate in units of mass per hour (Y-axis) and output in MW (X-axis) for a given type of emission. This curve applies when only one type of fuel is being burned.
emissionContent
The emission content per quantity of fuel burned
emissionType
The type of emission, which also gives the production rate measurement unit. The y1AxisUnits of the curve contains the unit of measure (e.g. kg) and the emissionType is the type of emission (e.g. sulfer dioxide).
CombinedCyclePlant
A set of combustion turbines and steam turbines where the exhaust heat from the combustion turbines is recovered to make steam for the steam turbines, resulting in greater overall plant efficiency
combCyclePlantRating
The combined cycle plant's output rating, in MW
CogenerationPlant
A set of thermal generating units for the production of electrical energy and process steam (usually from the output of the steam turbines). The steam sendout is typically used for industrial purposes or for municipal heating and cooling.
cogenHPSendoutRating
The high pressure steam sendout, in klb/hour
cogenHPSteamRating
cogenLPSendoutRating
The low pressure steam sendout, in klb/hour
cogenLPSteamRating
cogenPlantMWRating
The rated output MW of the cogeneration plant
CAESPlant
energyStorageCapacity
The rated energy storage capacity in megawatt-hours
ratedCapacityMW
The CAES plant's gross rated generating capacity in MW
AirCompressor
Combustion turbine air compressor which is an integral part of a compressed air energy storage (CAES) plant
airCompressorRating
EmissionAccount
Accounts for tracking emissions usage and credits for thermal generating units. A unit may have zero or more emission accounts, and will typically have one for tracking usage and one for tracking credits.
The type of emission, for example sulfur dioxide (SO2). The y1AxisUnits of the curve contains the unit of measure (e.g. kg) and the emissionType is the type of emission (e.g. sulfer dioxide).
emissionValueSource
The source of the emission value: Measured or Calculated
AccountBalance
GenerationDynamics
The Generation Dynamics package contains prime movers, such as turbines and boilers, which are needed for simulation and educational purposes.
Supercritical
Subcritical
SteamTurbine
crossoverTC
reheater1TC
reheater2TC
shaft1PowerHP
Fraction Of Power From Shaft 1 High Pressure Turbine output
shaft1PowerIP
Fraction Of Power From Shaft 1 Intermediate Pressure Turbine output
shaft1PowerLP1
Fraction Of Power From Shaft 1 First Low Pressure Turbine output
shaft1PowerLP2
Fraction Of Power From Shaft 1 Second Low Pressure Turbine output
shaft2PowerHP
Fraction Of Power From Shaft 2 High Pressure Turbine output
shaft2PowerIP
Fraction Of Power From Shaft 2 Intermediate Pressure Turbine output
shaft2PowerLP1
Fraction Of Power From Shaft 2 First Low Pressure Turbine output
shaft2PowerLP2
Fraction Of Power From Shaft 2 Second Low Pressure Turbine output
steamChestTC
SteamSupply
steamSupplyRating
PWRSteamSupply
Pressurized water reactor used as a steam supply to a steam turbine
coldLegFBLagTC
coldLegFBLeadTC1
coldLegFBLeadTC2
coldLegFG1
coldLegFG2
coldLegLagTC
coreHTLagTC1
coreHTLagTC2
coreNeutronicsEffTC
coreNeutronicsHT
feedbackFactor
hotLegLagTC
hotLegSteamGain
hotLegToColdLegGain
pressureCG
steamFlowFG
steamPressureDropLagTC
steamPressureFG
throttlePressureFactor
throttlePressureSP
PrimeMover
The machine used to develop mechanical energy used to drive a generator.
primeMoverRating
HeatRecoveryBoiler
The heat recovery system associated with combustion turbines in order to produce steam for combined cycle plants
steamSupplyRating2
The steam supply rating in kilopounds per hour, if dual pressure boiler
HydroTurbine
A water driven prime mover. Typical turbine types are: Francis, Kaplan, and Pelton.
gateRateLimit
gateUpperLimit
maxEffMWatMinHead
Maximum efficiency MW at minimum head conditions
maxEffMWatMaxHead
Maximum efficiency MW at maximum head conditions
speedRating
speedRegulation
transientDroopTime
transientRegulation
turbineRating
turbineType
Type of turbine, e.g.: Francis, Pelton, Kaplan
waterStartingTime
FossilSteamSupply
Fossil fueled boiler (e.g., coal, oil, gas)
auxPowerVersusFrequency
Off nominal frequency effect on auxiliary real power. Per unit MW variation versus per unit frequency variation.
auxPowerversusVoltage
Off nominal voltage effect on auxiliary real power. Per unit MW variation versus per unit kV variation.
controlIC
boilerControlMode
controlMWEB
controlPC
controlPEB
controlPED
controlTC
feedWaterIG
feedWaterPG
feedWaterTC
fuelDemandLimit
fuelSupplyDelay
mechPowerSensorLag
fuelSupplyTC
mWMaximumER
mWMinimumER
pressureCtrlDG
pressureCtrlIG
pressureCtrlPG
pressureFeedback
superHeater1Capacity
superHeater2Capacity
superHeaterPipePD
DrumBoiler
drumBoilerRating
CombustionTurbine
A prime mover that is typically fueled by gas or light oil
ambientTemp
Default ambient temperature to be used in modeling applications
Off-nominal frequency effect on turbine auxiliaries. Per unit reduction in auxiliary MW consumption versus per unit reduction in frequency (from rated frequency).
auxPowerVersusVoltage
Off-nominal voltage effect on turbine auxiliaries. Per unit reduction in auxiliary MW consumption versus per unit reduction in auxiliary bus voltage (from a specified voltage level).
capabilityVersusFrequency
Off-nominal frequency effect on turbine capability. Per unit reduction in unit MW capability versus per unit reduction in frequency (from rated frequency).
heatRecoveryFlag
Flag that is set to true if the combustion turbine is associated with a heat recovery boiler
powerVariationByTemp
Per unit change in power per (versus) unit change in ambient temperature
referenceTemp
Reference temperature at which the output of the turbine was defined.
timeConstant
BWRSteamSupply
Boiling water reactor used as a steam supply to a steam turbine
highPowerLimit
inCoreThermalTC
integralGain
lowerLimit
lowPowerLimit
pressureLimit
pressureSetpointGA
pressureSetpointTC1
pressureSetpointTC2
proportionalGain
rfAux1
Coefficient for modeling the effect of off-nominal frequency and voltage on recirculation and core flow, which affects the BWR power output.
rfAux2
rfAux3
rfAux4
rfAux5
rfAux6
rfAux7
rfAux8
rodPattern
rodPatternConstant
upperLimit
CTTempMWCurve
Relationship between the combustion turbine's power output rating in gross MW (X-axis) and the ambient air temperature in temperature units (Y-axis)
temperatureUnits
LoadModel
This package is responsible for modeling the energy consumers and the system load as curves and associated curve data. Special circumstances that may affect the load, such as seasons and daytypes, are also included here.This information is used by Load Forecasting and Load Management.
AreaLoadCurve
A curve relating power versus time. showing the values of a specific load for each unit of the period covered. The curve can be based on 'absolute' time or on 'normalized' time. An instance of this curve could represent the absolute area load forecast. An other instance could represent a normalized daily load curve for a particular day type.
AreaLossCurve
The relationship between total area MW losses (Y-axis) and total area MW load (X-axis)
CustomerMeter
A meter for measuring customer energy consumption. The typeName attribute indicates the type of customer meter.
DayType
Group of similar days, e.g., Mon/Tue/Wed, Thu/Fri, Sat/Sun, Holiday1, Holiday2
EquivalentLoad
A generic equivalent for an energy consumer on a transmission or distribution voltage level. It may be under load management and also has cold load pick up characteristics.
feederLoadMgtFactor
The feeder's contribution to load management, in percent
mVArColdPickUpFactor
The amount of nominal feeder MVAr that is picked up cold, in percent
mWColdPickUpFactor
The amount of nominal feeder MW that is picked up cold, in percent
phaseAmpRating
loadAllocationFactor
Permit assignment of loads on a participation factor basis. Given three equivalent loads with factors of 10, 25 and 15, a feeder load of 100 amps could be allocated on the feeder as 20, 50 and 30 amps.
InductionMotorLoad
Large three phase induction motor load. The typeName attribute indicates the type of induction motor (1 = wound rotor) (2 = squirrel cage).
LoadArea
LoadDemandModel
A curve of load versus time (X-axis) showing the values of MW (Y1-axis) and MVAr (Y2-axis) for each unit of the period covered. This curve represents a typical pattern of load over the time period for a given day type and season.
NonConformLoadSchedule
A MW (Y1-axis) and MVAr (Y2-axis) schedule (curves) versus time (X-axis) for non-conforming loads, e.g., large industrial load or power station service (where modeled)
Season
A specified time period of the year, e.g., Spring, Summer, Fall, Winter
endDate
startDate
StationSupply
PowerCutZone
An area or zone of the power system which is used for load shedding purposes.
cutLevel1
First level (amount) of load to cut as a percentage of total zone load
cutLevel2
Second level (amount) of load to cut as a percentage of total zone load
Meas
Contains entities that describe dynamic measurement data exchanged between applications.
Measurement
A Measurement represents any measured, calculated or non-measured non-calculated quantity. Any piece of equipment may contain Measurements, e.g. a substation may have temperature measurements and door open indications, a transformer may have oil temperature and tank pressure measurements, a bay may contain a number of power flow measurements and a Breaker may contain a switch status measurement.The PSR - Measurement association is intended to capture this use of Measurement and is included in the naming hierarchy based on EquipmentContainer. The naming hierarchy typically has Measurements as leafs, e.g. Substation-VoltageLevel-Bay-Switch-Measurement.Some Measurements represent quantities related to a particular sensor position, e.g. a voltage transformer (PT) at a busbar or a current transformer (CT) at the bar between a breaker and an isolator. The sensing position is not captured in the PSR - Measurement association. Instead it is captured by the Measurement - Terminal association that makes it possible to place the sensing position at a well defined place. The place is defined by the connection of the Terminal to ConductingEquipment.Two possible paths exist:1) Measurement-Terminal- ConnectivityNode-Terminal-ConductingEquipment2) Measurement-Terminal-ConductingEquipmentAlternative 2 is the only allowed use. Use of Measurement-PSR and Measurement-Terminal are allowed at the same time for a particular Measurement. Measurement-PSR defines the measurements in the naming hierarchy and the Measurement-Terminal defines where the measurement is placed in the network topology.
positiveFlowIn
If true then this measurement is a MW, MVAR or AMPS with the convention that a positive value measured at the Terminal means power is flowing into the related PowerSystemResource.
maxValue
Normal value range maximum for any of the MeasurementValue.values. Used for scaling, e.g. in bar graphs or of telemetered raw values.
minValue
Normal value range minimum for any of the MeasurementValue.values. Used for scaling, e.g. in bar graphs or of telemetered raw values
dataType
One of the enumerated NumericTypes specifying the data type for nominal, min, max, etc., value of MeasurementValue.
normalValue
Normal measurement value, e.g., used for percentage calculations.
MeasurementValueQuality
Measurement quality flags. Bits 0-10 are defined for substation automation in draft IEC 61850 part 7-3. Bits 11-15 are reserved for future expansion by that document. Bits 16-31 are reserved for EMS applications.
MeasurementValue
The current state for a measurement. A state value is an instance of a measurement from a specific source. Measurements can be associated with many state values, each representing a different source for the measurement.
timeStamp
The time when the value was last updated
sensorAccuracy
The limit, expressed as a percentage of the sensor maximum, that errors will not exceed when the sensor is used under reference conditions.
ValueAliasSet
Describes the translation of a set of values into a name. Each ValueAliasSet has a name, description etc. A specific Measurement may represent a discrete state like Open, Closed, Intermediate etc. This requires a translation from the MeasurementValue.value number to a string, e.g. 0->'Invalid', 1->'Open', 2->'Closed', 3->'Intermediate'
ValueToAlias
Describes the translation of one particular value into a name, e.g. 1->'Open'
LimitSet
Specifies a set of Limits that are associated with a Measurement. A Measurement may have several LimitSets corresponding to seasonal or other changing conditions. The condition is captured in the name and description attributes. The same LimitSet may be used for several Measurements. In particular percentage limits are used this way.
isPercentageLimits
Tells if the limit values are in percentage of normalValue or the specified Unit for Measurements and Controls.
Limit
Specifies one limit value for a Measurement. A Measurement typically has several limits that are kept together by the LimitSet class. The actual meaning and use of a Limit instance (i.e., if it is an alarm or warning limit or if it is a high or low limit) is not captured in the Limit class. However the name of a Limit instance may indicate both meaning and use.
Control
Control is used for supervisory/device control. It represents control outputs that are used to change the state in a process, e.g. close or open breaker, a set point value or a raise lower command.
The value representing the actuator output
operationInProgress
Indicates that a client is currently sending control commands that has not completed
Normal value range maximum for any of the Control.value. Used for scaling, e.g. in bar graphs.
Normal value range minimum for any of the Control.value. Used for scaling, e.g. in bar graphs.
Specify the data type for Control.value.
Normal value for Control.value e.g. used for percentage scaling
MeasurementValueSource
MeasurementValueSource describes the alternative sources updating a MeasurementValue. User conventions for how to use the MeasurementValueSource attributes are described in the introduction to IEC 61970-301.
MeasurementType
Specifies the type of Measurement, e.g. IndoorTemperature, OutDoorTemperature, BusVoltage, GeneratorVoltage, LineFlow etc. The MeasurementType.name shall be unique among all specified types and describe the type. The MeasurementType.aliasName is meant to be used for localization.
ControlType
Specifies the type of Control, e.g. BreakerOn/Off, GeneratorVoltageSetPoint, TieLineFlow etc. The ControlType.name shall be unique among all specified types and describe the type. The ControlType.aliasName is meant to be used for localization.
Quality61850
Quality flags in this class are as defined in IEC 61850, except for estimatorReplaced, which has been included in this class for convenience.
validity
Validity may be good, questionable or invalid. Refer to the Validity enumeration for more details.
overFlow
Measurement value is beyond the capability of being represented properly. For example, a counter value overflows from maximum count back to a value of zero.
outOfRange
Measurement value is beyond a predefined range of value.
badReference
Measurement value may be incorrect due to a reference being out of calibration.
oscillatory
To prevent some overload of the communication it is sensible to detect and suppress oscillating (fast changing) binary inputs. If a signal changes in a defined time (tosc) twice in the same direction (from 0 to 1 or from 1 to 0) then oscillation is detected and the detail quality identifier 'oscillatory' is set. If it is detected a configured numbers of transient changes could be passed by. In this time the validity status 'questionable' is set. If after this defined numbers of changes the signal is still in the oscillating state the value shall be set either to the opposite state of the previous stable value or to a defined default value. In this case the validity status 'questionable' is reset and 'invalid' is set as long as the signal is oscillating. If it is configured such that no transient changes should be passed by then the validity status 'invalid' is set immediately in addition to the detail quality identifier 'oscillatory' (used for status information only).
failure
This identifier indicates that a supervision function has detected an internal or external failure, e.g. communication failure.
oldData
Measurement value is old and possibly invalid, as it has not been successfully updated during a specified time interval.
suspect
A correlation function has detected that the value is not consitent with other values. Typically set by a network State Estimator.
test
Measurement value is transmitted for test purposes.
operatorBlocked
Measurement value is blocked and hence unavailable for transmission.
source
estimatorReplaced
Value has been replaced by State Estimator. estimatorReplaced is not an IEC61850 quality bit but has been put in this class for convenience.
Outage
An extension to the Core and Wires packages that models information on the current and planned network configuration. These entities are optional within typical network applications.
OutageSchedule
The period of time that a piece of equipment is out of service, for example, for maintenance or testing; including the equipment's MW rating while under maintenance. The X-axis represents absolute time and the Y-axis represents the equipment's available rating while out of service.
SwitchingOperation
A SwitchingOperation is used to define individual switch operations for an OutageSchedule. This OutageSchedule may be associated with another item of Substation such as a Transformer, Line, or Generator; or with the Switch itself as a PowerSystemResource. A Switch may be referenced by many OutageSchedules.
operationTime
Time of operation in same units as OutageSchedule.xAxixUnits.
newState
ClearanceTag
A clearance tag that is used to authorize and schedule work on conducting equipment in the field. Tagged equipment is not available for commercial service.
authorityName
The name of the person who is authorized to issue the tag
clearanceTagType
The type of tag, depending on the purpose of the work to be performed and/or the type of supervisory control allowed.
deenergizeReqFlag
Flag = YES if equipment must be deenergized
groundReqFlag
Flag = YES if equipment must be grounded
phaseCheckReqFlag
Flag = YES if equipment phasing must be checked
tagIssueTime
The time at which the clearance tag was issued
workDescription
workEndTime
The time at which the clearance tag is scheduled to be removed
workStartTime
Protection
An extension to the Core and Wires packages that models information for protection equipment such as relays. These entities are used within training simulators and distribution network fault location applications.
CurrentRelay
A device that checks current flow values in any direction or designated direction
currentLimit1
Current limit #1 for inverse time pickup
currentLimit2
Current limit #2 for inverse time pickup
currentLimit3
Current limit #3 for inverse time pickup
inverseTimeFlag
True/False flag that indicates whether or not the current relay has inverse time characteristic.
timeDelay1
Inverse time delay #1 for current limit #1
timeDelay2
Inverse time delay #2 for current limit #2
timeDelay3
Inverse time delay #3 for current limit #3
ProtectionEquipment
An electrical device designed to respond to input conditions in a prescribed manner and after specified conditions are met to cause contact operation or similar abrupt change in associated electric control circuits, or simply to display the detected condition. Protection equipment are associated with conducting equipment and usually operate circuit breakers. For protection relays, the typeName attribute is a type identifier as specified by IEC 61850 with a Pro_ prefix, e.g. Pro_OVR for overvoltage relay.
relayDelayTime
The time delay in seconds from detection of abnormal conditions to relay operation
highLimit
lowLimit
powerDirectionFlag
Direction same as positive active power flow value.
RecloseSequence
A reclose sequence (open and close) is defined for each possible reclosure of a breaker.
recloseDelay
Indicates the time lapse before the reclose step will execute a reclose.
recloseStep
Indicates the ordinal position of the reclose step relative to other steps in the sequence.
SynchrocheckRelay
A device that operates when two AC circuits are within the desired limits of frequency, phase angle, and voltage, to permit or to cause the paralleling of these two circuits. Used to prevent the paralleling of non-synchronous topological islands.
maxAngleDiff
The maximum allowable voltage vector phase angle difference across the open device
maxFreqDiff
The maximum allowable frequency difference across the open device
maxVoltDiff
The maximum allowable difference voltage across the open device
Topology
An extension to the Core Package that in association with the Terminal class models Connectivity, that is the physical definition of how equipment is connected together. In addition it models Topology, that is the logical definition of how equipment is connected via closed switches. The Topology definition is independent of the other electrical characteristics.
ConnectivityNode
Connectivity nodes are points where terminals of conducting equipment are connected together with zero impedance.
TopologicalIsland
An electrically connected subset of the network. Topological islands can change as the current network state changes (i.e., disconnect switches, breakers, etc. change state).
TopologicalNode
A set of connectivity nodes that, in the current network state, are connected together through closed switches. Topological nodes can change as the current network state changes (i.e., switches, breakers, etc. change state).
energized
loadCarrying
netInjectionMVar
netInjectionMW
observabilityFlag
phaseAngle
voltage
Wires
An extension to the Core and Topology package that models information on the electrical characteristics of Transmission and Distribution networks. This package is used by network applications such as State Estimation, Load Flow and Optimal Power Flow.
ACLineSegment
A wire or combination of wires, with consistent electrical characteristics, building a single electrical system, used to carry alternating current between points in the power system.
Breaker
A mechanical switching device capable of making, carrying, and breaking currents under normal circuit conditions and also making, carrying for a specified time, and breaking currents under specified abnormal circuit conditions e.g. those of short circuit. The typeName is the type of breaker, e.g., oil, air blast, vacuum, SF6.
ampRating
inTransitTime
The transition time from open to close, in seconds
BusbarSection
A conductor, or group of conductors, with negligible impedance, that serve to connect other conducting equipment within a single substation.Voltage measurements are typically obtained from VoltageTransformers that are connected to busbar sections. A bus bar section may have many physical terminals but for analysis is modelled with exactly one logical terminal. The typeName attribute indicates the type of bus bar section, e.g.: Main, Transfer.
Compensator
A shunt or series capacitor or switchable bank of shunt or series capacitors. The shunt or series application of a capacitor bank is determined by its connectivity in the network. A shunt compensator has only one terminal (ground implied) and series compensator has two terminals.
aVRDelay
Time delay in seconds required for the device to be connected or disconnected by automatic voltage regulation (AVR).
impedance
The positive sequence impedance of the capacitor.
maximumkV
The maximum voltage at which the capacitor bank should operate.
maximumSections
For a capacitor bank, the maximum number of sections that may be switched in.
minimumkV
The minimum voltage at which the capacitor bank should operate.
mVArPerSection
For a capacitor bank, the size in MVAr of each switchable section at the Nominal kV.
nominalkV
The nominal voltage at which the nominal MVAr was measured. This should normally be within 10% of the voltage at which the capacitor is connected to the network.
nominalMVAr
Nominal MVAr output of the capacitor bank at the nominal kV. This number should be positive.
normalSections
For a capacitor bank, the normal number of sections switched in. This number should correspond to the Nominal MVAr.
Positive sequence resistance of the capacitor bank.
switchOnCount
The switch on count since the capacitor count was last reset or initialized.
switchOnDate
The date and time when the capacitor bank was last switched on.
voltSensitivity
Voltage sensitivity required for the device to regulate the bus voltage, in per unit voltage/MVAr.
Positive sequence reactance of the capacitor bank.
yPerSection
For a capacitor bank, the admittance of each switchable section. Calculated using the MVAr per section and corrected for network voltage.
compensatorType
Used to indicate how many terminals compensator has. A shunt compensator has only one terminal (ground implied), while a series compensator has two terminals.
Conductor
Combination of conducting material with consistent electrical characteristics, building a single electrical system, used to carry current between points in the power system.
b0ch
Zero sequence shunt (charging) susceptance, uniformly distributed, of the entire line section.
bch
Positive sequence shunt (charging) susceptance, uniformly distributed, of the entire line section.
g0ch
Zero sequence shunt (charging) conductance, uniformly distributed, of the entire line section.
gch
Positive sequence shunt (charging) conductance, uniformly distributed, of the entire line section.
length
Segment length for calculating line section capabilities (long length units)
Positive sequence series resistance of the entire line section.
Zero sequence series resistance of the entire line section.
Positive sequence series reactance of the entire line section.
Zero sequence series reactance of the entire line section.
ConductorType
Wire or cable conductor (per IEEE specs). A specific type of wire or combination of wires not insulated from one another, suitable for carrying electric current. It may be bare or insulated.
sheathResistance
Resistance of the sheath for cable conductors.
sheathReactance
Reactance of the sheath for cable conductors.
DCLineSegment
A wire or combination of wires not insulated from one another, with consistent electrical characteristics, used to carry direct current between points in the DC region of the power system.
dcSegmentInductance
Inductance of the DC line segment, in millihenries
dcSegmentResistance
Resistance of the DC line segment, in ohms
Disconnector
A manually operated or motor operated mechanical switching device used for changing the connections in a circuit, or for isolating a circuit or equipment from a source of power. It is required to open or close circuits when negligible current is broken or made.
Fuse
An overcurrent protective device with a circuit opening fusible part that is heated and severed by the passage of overcurrent through it. A fuse is considered a switching device because it breaks current.
Ground
A common point for connecting grounded conducting equipment such as shunt capacitors. The power system model can have more than one ground. The typeName indicates the type of ground, e.g., mesh, earth rod. It is recommended to use GroundDisconnector instead of Ground class when applying CIM. In case of grounding a shunt compensator use Compensator of type SHUNT.
HeatExchanger
Equipment for the cooling of electrical equipment and the extraction of heat
Jumper
A short section of conductor with negligible impedance which can be manually removed and replaced if the circuit is de-energized. Note that zero-impedance branches can be modelled by an ACLineSegment with a zero impedance ConductorType
RectifierInverter
Bi-directional AC-DC conversion equipment that can be used to control DC current, DC voltage, DC power flow, or firing angle.
ratedKV
bridges
commutatingReactance
Commutating reactance in ohms at AC bus frequency
commutatingResistance
compoundResistance
minCompoundVoltage
RegulationSchedule
A pre-established pattern over time for a controlled variable, e.g., busbar voltage.
lineDropCompensation
Flag to indicate that line drop compensation is to be applied
lineDropR
lineDropX
StaticVarCompensator
A facility for providing variable and controllable shunt reactive power. The SVC typically consists of a stepdown transformer, filter, thyristor-controlled reactor, and thyristor-switched capacitor arms.
capacitiveRating
Maximum available capacitive reactive power
inductiveRating
Maximum available inductive reactive power
sVCControlMode
slope
voltageSetPoint
Switch
A generic device designed to close, or open, or both, one or more electric circuits. The typeName attribute may be used to indicate that the database switch does not represent a corresponding real device but has been introduced for modeling purposes only.
normalOpen
Set if the switching device is normally open.
The switch on count since the switch was last reset or initialized.
The date and time when the switch was last switched on.
TapChanger
Mechanism for changing transformer winding tap positions. The typeName attribute indicates type of changer, designated as 'Fixed' or 'LTC.'
highStep
Highest possible tap step position, advance from neutral
initialDelay
For an LTC, the delay for initial tap changer operation (first step change)
lowStep
Lowest possible tap step position, retard from neutral
neutralKV
Voltage at which the winding operates at the neutral tap setting.
neutralStep
The neutral tap step position for this winding.
normalStep
The tap step position used in 'normal' network operation for this winding. For a 'Fixed' tap changer indicates the current physical tap setting.
stepPhaseShiftIncrement
Phase shift, in degrees, per step position. A positive value indicates a positive phase shift from the winding where the tap is located to the other winding (for a two-winding transformer), or to the “T” point (for a three-winding transformer).
stepVoltageIncrement
Tap step increment, in per cent of nominal voltage, per step position.
subsequentDelay
For an LTC, the delay for subsequent tap changer operation (second and later step changes)
tculControlMode
For an LTC, the tap changer control mode, e.g.: Off, Local, Volt, MVAr
PowerTransformer
An electrical device consisting of two or more coupled windings, with or without a magnetic core, for introducing mutual coupling between electric circuits. Transformers can be used to control voltage and phase shift (MW flow). The typeName attribute indicates type of transformer.
bmagSat
Core shunt magnetizing susceptance in the saturation region, in per cent.
magBaseKV
The reference voltage at which the magnetizing saturation measurements were made
magSatFlux
Core magnetizing saturation curve knee flux level.
Describes the phases carried by a power transformer. Possible values { ABCN , ABC, ABN, ACN, BCN, AB, AC, BC, AN, BN, CN, A, B, C, N }.
transfCoolingType
transformerType
TransformerWinding
A winding is associated with each defined terminal of a transformer (or phase shifter).
insulationKV
connectionType
The type of connection of the winding (e.g. Delta, Wye, zigzag)
emergencyMVA
The MVA that the winding can carry under emergency conditions.
grounded
Positive sequence series resistance of the winding.
Zero sequence series resistance of the winding.
The rated voltage (phase-to-ground) of the winding, usually the same as the neutral voltage.
ratedMVA
rground
Ground resistance path through connected grounding transformer.
shortTermMVA
MVA that the winding can carry for a short period of time.
windingType
The type of winding, i.e., Primary, Secondary, Tertiary, Quaternary.
Positive sequence series reactance of the winding.
Zero sequence series reactance of the winding.
xground
Ground reactance path through connected grounding transformer.
Line
A component part of a system extending between adjacent substations or from a substation to an adjacent interconnection point.
VoltageControlZone
An area of the power system network which is defined for secondary voltage control purposes. A voltage control zone consists of a collection of substations with a designated bus bar section whose voltage will be controlled.
WindingTest
Physical winding test data for the winding/tap pairs of a transformer (or phase shifter). This test data can be used to derive other attributes of specific transformer or phase shifter models.
excitingCurrent
The exciting current % ('to' winding open-circuited) from the test report.
fromTapStep
The tap step number for the 'from' winding of the test pair.
leakageImpedance
The leakage impedance measured at the 'from' winding with the 'to' winding short-circuited and all other windings open-circuited. Leakage impedance is expressed in units based on the MVA and kV ratings of the 'from' winding.
loadLoss
The load loss kW ('to' winding short-circuited) from the test report.
noLoadLoss
The no load loss kW 'to' winding open-circuited) from the test report.
phaseShift
The phase shift measured at the open-circuited 'to' winding, with the 'from' winding set to the 'from' winding's rated voltage and all other windings open-circuited.
toTapStep
The tap step number for the 'to' winding of the test pair.
The voltage measured at the open-circuited 'to' winding, with the 'from' winding set to the 'from' winding's rated voltage and all other windings open-circuited.
SynchronousMachine
An electromechanical device that operates synchronously with the network. It is a single machine operating either as a generator or synchronous condenser or pump.
aVRToManualLag
Time delay, in seconds, required when switching from AVR to manual for a lagging MVAr violation.
aVRToManualLead
Time delay, in seconds, required when switching from Automatic Voltage Regulation to Manual for a leading MVAr violation.
baseMVAr
Default base MVAr value. This value represents the initial MVAr that can be used by any application function.
coolantCondition
Temperature or pressure of coolant medium
coolantType
Method of cooling the machine, e.g., air, hydrogen gas, water
damping
Damping torque coefficient, a proportionality constant that, when multiplied by the angular velocity of the rotor poles with respect to the magnetic field (frequency), results in the damping torque.
inertia
The energy stored in the rotor when operating at rated speed. This value is used in the accelerating power reference frame for operator training simulator solutions.
manualToAVR
Time delay, in seconds, required when switching from Manual to Automatic Voltage Regulation. This value is used in the accelerating power reference frame for powerflow solutions
maximumKV
maximumMVAr
Maximum MVAr limit. This is the maximum (nameplate) limit for the unit.
minimumKV
minimumMVAr
Positive sequence resistance of the synchronous machine.
Zero sequence resistance of the synchronous machine.
Positive sequence reactance of the synchronous machine.
Zero sequence reactance of the synchronous machine.
xDirectSubtrans
Direct-axis subtransient reactance, also known as X'd.
xDirectSync
Direct-axis synchronous reactance. The quotient of a sustained value of that AC component of armature voltage that is produced by the total direct-axis flux due to direct-axis armature current and the value of the AC component of this current, the machine running at rated speed. (Xd)
xDirectTrans
Direct-axis transient reactance, also known as X'd.
xQuadSubtrans
Quadrature-axis subtransient reactance, also known as X'q.
xQuadSync
Quadrature-axis synchronous reactance (Xq) , the ratio of the component of reactive armature voltage, due to the quadrature-axis component of armature current, to this component of current, under steady state conditions and at rated frequency.
xQuadTrans
Quadrature-axis transient reactance, also known as X'q.
operatingMode
Current mode of operation, i.e., generator or condenser
type
Modes that this synchronous machine can operate in, i.e., as a generator, condenser, or both
condenserMW
MVArCapabilityCurve
Reactive power rating envelope versus the synchronous machine's active power, in both the generating and motoring modes. For each MW value there is a corresponding high and low MVAr limit value. Typically there will be a separate curve for each coolant condition, such as hydrogen pressure.
coolantTemperature
The machine's coolant temperature in degrees Celsius (e.g., ambient air or stator circulating water)
hydrogenPressure
EquivalentSource
A generic equivalent for an energy supplier on a transmission or distribution voltage level.
Negative sequence Thevenin reactance in Ohms.
Negative sequence Thevenin resistance in Ohms.
Positive sequence Thevenin reactance in Ohms.
Positive sequence Thevenin resistance in Ohms.
voltageAngle
voltageMagnitude
Phase-to-phase open circuit voltage magnitude.
Zero sequence Thevenin reactance in Ohms.
Zero sequence Thevenin resistance in Ohms.
WireType
Wire conductor (per IEEE specs). A specific type of wire or combination of wires, not insulated from each other, suitable for carrying electrical current.
phaseConductorCount
Number of conductor strands in the (symmetrical) bundle (1-12)
phaseConductorSpacing
Distance between conductor strands in a (symmetrical) bundle (short length units)
Current carrying capacity, expressed in amperes, of a wire or cable under stated thermal conditions
gMR
Geometric Mean Radius. If we replace the conductor by a thin walled tube of radius GMR, then its reactance is identical to the reactance of the actual conductor.
radius
resistance
The resistance per unit length of the conductor
WireArrangement
Identification, spacing and configuration of the wires of a ConductorType, with reference to their type.
mountingPointX
Mounting point where wire One is mounted.
mountingPointY
LoadBreakSwitch
A mechanical switching device capable of making, carrying, and breaking currents under normal operating conditions.
Junction
A point where one or more conducting equipments are connected with zero resistance.
EnergyConsumer
Generic user of energy - a point of consumption on the power system model
conformingLoadFlag
Flag is set to YES if the load is conforming, i.e., tracks the area load to which the energy consumer belongs
customerCount
Number of individual customers represented by this Demand
pFexp
Exponent of per unit frequency effecting real power.
pfixed
Real component of the load that is a fixed quantity, MW.
pfixedPct
Fixed MW as per cent of load group fixed MW
pnom
Nominal value for real power, MW. Nominal real power is adjusted according to the load profile selected for the consumer. It equates to one per unit in the load profile.
pnomPct
Nominal MW as per cent of load group nominal MW
powerFactor
Power factor for nominal portion of load. Defined as MW/MVA
pVexp
Exponent of per unit voltage effecting real power.
qFexp
Exponent of per unit frequency effecting reactive power
qfixed
Reactive component of the load that is a fixed quantity, MVAr.
qfixedPct
Fixed MVAr as per cent of load group fixed MVAr
qnom
qnomPct
Nominal MVAr as per cent of load group nominal MVAr
qVexp
Exponent of per unit voltage effecting reactive power.
Connector
A conductor, or group of conductors, with negligible impedance, that serve to connect other conducting equipment within a single substation and are modelled with a single logical terminal.
RegulatingCondEq
RegulatingCondEq is a type of ConductingEquipment that can regulate Measurements and have a RegulationSchedule.
GroundDisconnector
A manually operated or motor operated mechanical switching device used for isolating a circuit or equipment from Ground.
CompositeSwitch
A model of a set of individual Switches normally enclosed within the same cabinet and possibly with interlocks that restrict the combination of switch positions. These are typically found in medium voltage distribution networks.A CompositeSwitch could represent a Ring-Main-Unit (RMU), or pad-mounted switchgear, with primitive internal devices such as an internal bus-bar plus 3 or 4 internal switches each of which may individually be open or closed. A CompositeSwitch and a set of contained Switches can also be used to represent a multi-position switch e.g. a switch that can connect a circuit to Ground, Open or Busbar.
compositeSwitchType
Financial
This package is responsible for Settlement and Billing. These classes represent the legal entities who participate in formal or informal agreements.
IntSchedAgreement
A type of agreement that provides the default method by which interchange schedules are to be integrated to obtain hourly MWh schedules for accounting.
defaultIntegrationMethod
The default method by which interchange schedules are to be integrated to obtain hourly MWh schedules for accounting. Method #1 is to integrate the instantaneous schedule between the hourly boundaries. Method #2 compensates for any up/down ramping that occurs across the hourly boundary (this is called block accounting).
GenerationProvider
The energy seller in the energy marketplace.
ControlAreaOperator
Operates the Control Area. Approves and implements energy transactions. Verifies both Inter-Control Area and Intra-Control Area transactions for the power system before granting approval (and implementing) the transactions.
TransmissionProvider
Provider of the transmission capacity (interconnecting wires between Generation and Consumption) required to fulfill and Energy Transaction's energy exchange. Posts information for transmission paths and AvailableTransmissionCapacities on a reservation node. Buys and sells its products and services on the same reservation node.
CustomerConsumer
The energy buyer in the energy marketplace.
Marketer
Matches buyers and sellers, and secures transmission (and other ancillary services) needed to complete the energy transaction.
TransmissionProduct
transmissionProductType
Type of the transmission product. This could be a transmission service class (firm, total transmission capability, or non-firm), transmission service period (on-peak, full-period, off-peak), transmission service increments (yearly extended, hourly fixed, monthly sliding, etc.), transmission service type (network, available transmission capability, or point-to-point, or a transmission service window (fixed hourly, sliding weekly, extended monthly, etc.).
OpenAccessProduct
Contracts for services offered commercially.
EnergyScheduling
This package provides the capability to schedule and account for transactions for the exchange of electric power between companies. It includes transations for megawatts which are generated, consumed, lost, passed through, sold and purchased. These classes are used by Accounting and Billing for Energy, Generation Capacity, Transmission, and Ancillary Services.
DynamicSchedule
A continuously variable component of a control area's MW net interchange schedule. Dynamic schedules are sent and received by control areas.
dynSchedSignRev
Dynamic schedule sign reversal required (yes/no)
dynSchedStatus
The 'active' or 'inactive' status of the dynamic schedule
EnergyTransaction
Specifies the schedule for energy transfers between interchange areas that are necessary to satisfy the associated interchange transaction.
firmInterchangeFlag
Firm interchange flag indicates whether or not this energy transaction can be changed without potential financial consequences.
state
reason
energyMin
congestChargeMax
Maximum congestion charges in monetary units
receiptPointEnergy
deliveryPointEnergy
Delivery point typically expressed in MW
InadvertentAccount
An account for tracking inadvertent interchange versus time for each control area. A control area may have more than one inadvertent account in order to track inadvertent over one or more specific tie points in addition to the usual overall net inadvertent. Separate accounts would also be used to track designated time periods, such as on-peak and off-peak.
AreaReserveSpec
The control area's reserve specification
areaReserveSpecName
The Identification or name of the control area's reserve specification. A particular specification could correspond to pre-defined power system conditions, e.g., emergency situations.
lowerRegMarginReqt
Lower regulating margin requirement in MW, the amount of generation that can be dropped by control in 10 minutes
opReserveReqt
Operating reserve requirement in MW, where operating reserve is the generating capability that is fully available within 30 minutes. Operating reserve is composed of primary reserve (t less than 10 min) and secondary reserve (10 less than t less than 30 min).
primaryReserveReqt
Primary reserve requirement in MW, where primary reserve is generating capability that is fully available within 10 minutes. Primary reserve is composed of spinning reserve and quick-start reserve.
raiseRegMarginReqt
Raise regulating margin requirement in MW, the amount of generation that can be picked up by control in 10 minutes
spinningReserveReqt
Spinning reserve requirement in MW, spinning reserve is generating capability that is presently synchronized to the network and is fully available within 10 minutes
HostControlArea
A HostControlArea has a set of tie points and a set of generator controls (i.e., AGC). It also has a total load, including transmission and distribution losses.
areaControlMode
The area's present control mode: (CF = constant frequency) or (CTL = constant tie-line) or (TLB = tie-line bias) or (OFF = off control)
freqSetPoint
The present power system frequency set point for automatic generation control
frequencyBiasFactor
The control area's frequency bias factor, in MW/0.1 Hz, for automatic generation control (AGC)
EnergyProduct
An EnergyProduct is offered commercially as a ContractOrTariff.
EnergyProfile
Specifies the start time, stop time, level for an EnergyTransaction.
LossProfile
LossProfile is associated with an EnerrgyTransaction and must be completely contained within the time frame of the EnergyProfile associated with this EnergyTransaction.
CurtailmentProfile
Curtailing entity must be providing at least one service to the EnergyTransaction. The CurtailmentProfile must be completely contained within the EnergyProfile timeframe for this EnergyTransaction.
AvailableTransmissionCapacity
TieLine
TransmissionCorridor
A corridor containing one or more rights of way
TransmissionRightOfWay
A collection of transmission lines that are close proximity to each other.
Profile
ProfileData
sequenceNumber
Sequence to provide item numbering for the profile. { greater than or equal to 1 }
startDateTime
stopDateTime
capacityLevel
energyLevel
Block
A block is a simple transaction type, with no additional relationships.
Dynamic
A dynamic energy transaction has more complex relationships than a simple block type. It behaves like a pseudo tie line.
Reserve
Reservation
This package includes information for Transaction Scheduling for Energy, Generation Capacity, Transmission, and Ancillary Services.
AncillaryService
All of these services relateto various aspects of insuring that the production of energy matches consumption of energy at any given time. They are very critical to the security and reliability of the interconnected network. Some examples of AncillaryServices include Operating/Supplemental Reserve, Energy Imbalance Service, Operating/Spinning Reserve, Reactive Supply and Voltage Control, and Regulation and Frequency Response.
TransmissionService
Transmission products along posted transmission path.
TransmissionPath
An electrical connection, link, or line consisting of one or more parallel transmission elements between two areas of the interconnected electric systems, or portions thereof. TransmissionCorridor and TransmissionRightOfWay refer to legal aspects. The TransmissionPath refers to the segments between a TransmissionProvider’s ServicePoints.
availTransferCapability
The available transmission capability of a transmission path for the reference direction
parallelPathFlag
Flag which indicates if the transmission path is also a designated interconnection 'parallel path'
totalTransferCapability
The total transmission capability of a transmission path in the reference direction
ServicePoint
Each ServicePoint is contained within (or on the boundary of) an ElectronicIinterchangeArea. ServicePoints are defined termination points of a transmission path (down to distribution level or to a customer - generation or consumption or both).
ServiceReservation
A ServiceReservation is a reservation for either AncillaryServices or TransmissionServices. In the case of TransmissionServices, this is the right to some amount of AvailableTransmissionCapacity for a product on a path in a direction for some specific period of time
TiePoint
Site of an interface between interchange areas. The tie point can be a network branch (e.g., transmission line or transformer) or a switching device. For transmission lines, the interchange area boundary is usually at a designated point such as the middle of the line. Line end metering is then corrected for line losses.
tiePointMWRating
SCADA
Contains entities to model information used by Supervisory Control and Data Acquisition (SCADA) applications. Supervisory control supports operator control of equipment, such as opening or closing a breaker. Data acquisition gathers telemetered data from various sources. The subtypes of the Telemetry entity deliberately match the UCA and IEC 61850 definitions.This package also supports alarm presentation but it is not expected to be used by other applications.
CommunicationLink
The connection to remote units is through one or more communication links. Reduntant links may exist. The CommunicationLink class inherit PowerSystemResource. The intention is to allow CommunicationLinks to have Measurements. These Measurements can be used to model link status as operational, out of service, unit failure etc.
RemoteUnit
A remote unit can be a RTU, IED, substation control system, control center etc. The communication with the remote unit can be through various standard protocols (e.g. IEC 61870, IEC 61850) or non standard protocols (e.g. DNP, RP570 etc.). A remote unit contain remote data points that might be telemetered, collected or calculated. The RemoteUnit class inherit PowerSystemResource. The intention is to allow RemotUnits to have Measurements. These Measurements can be used to model unit status as operational, out of service, unit failure etc.
remoteUnitType
A remote unit can be a RTU, IED, substation control system, control center etc.
RemoteSource
Remote sources are state variables that are telemetered or calculated within the remote unit.
sensorMaximum
The maximum value the telemetry item can return.
sensorMinimum
The minimum value the telemetry item can return.
scanInterval
deadband
The smallest change in value to be reported.
RemoteControl
Remote controls are ouputs that are sent by the remote unit to actuators in the process.
remoteControlled
actuatorMaximum
actuatorMinimum
RemotePoint
For a RTU remote points correspond to telemetered values or control outputs. Other units (e.g. control centers) usually also contain calculated values.
The IEC 61968 subdirectories of the CIM are developed, standardized and maintained by IEC TC57 Working Group 14: System Interfaces for Distribution Management (WG14).
CimIec61968Version
This is the CIM version number assigned to this UML model file for all IEC 61968 packages. For all other packages, refer to 'CimVersion' in Main.
Assets
This package is used to define asset-level models for objects. Assets may be comprised of other assets and may have relationships to other assets. Assets also have owners and values. Assets may also have a relationship to a PowerSystemResource in the Wires model.
AssetBasics
Asset basics package; it is the top level of asset hierarchy.
Asset
A tangible resource of the utility, including power system equipment, cabinets, buildings, etc. For electrical network equipment, the role of the asset is defined in the Wires Model (refer to IEC 61970-301). This role is associated with an asset description, which places emphasis on the physical characteristics of the equipment fulfilling that role. This is the parent class for asset sub classes.
code
utc
Uniquely Tracked Commodity (UTC) number.
serialNumber
assetType
maufacturedDate
warrantyDate
financialValue
critical
True if asset is considered critical for some reason. For example, a pole with critical attachments.
condition
Condition of asset in inventory or at time of installation. Examples include new, rebuilt, overhaul required, other. Refer to inspection data for information on the most current condition of the asset.
plantTransferDate
Date asset's financial value was put in plant for regulatory accounting purposes (e.g., for rate base calculations). This is sometime referred to as the 'in-service date.'
usage
Asset usage. Examples include: Distribution Overhead, Distribution Underground, Transmission, Substation, Streetlight, Customer Substation, Unknown, Other.
purchaseDate
purchasePrice
Purchase price (amount, units) of asset.
purchaseOrderNumber
testStatus
True (=1) if asset has passed acceptance test and may be placed in or is in service. It is returned to a false state (=0) if asset is removed from service and is required to be tested again before being placed back in service, possibly in a new location. The date of each acceptance test (device may go through multiple test during its life cycle) is determined in AssetStatus.
statusDate
currentStatus
Status at the time of 'statusDate.' Asset is new construction (installed, ready to be placed in operation), in-service, decommissioned (out-of-service), removed, existing, proposed abandoned, proposed install, proposed remove, proposed replace, unknown, other.For history of status changes, refer to assoicated activity records.
lotNumber
Even for the same model and version number, many assets are manufactured in lots. the lotNumber identifies the specific lot for this asset.
Property
Property is a name-value pair concept that provides the means for utilities to describe various myriad properties for a given asset, asset type (AssetModel), or other object that is not included in the standard model.
propertyType
propertyValue
Value holds the actual value of the property for the object.
AssetModel
A type of an asset, usually a particular product model. There are typically many instances of an asset associated with a single asset model.
number
version
Version number for product model, which indicates vintage of the product.
corpStandard
Indicates if this type of asset is an approved coporate standard or otherwise: standard, experimental, under evaluation, other.
The intended usage for this type of asset. Examples include: Distribution Overhead, Distribution Underground, Transmission, Substation, Streetlight, Customer Substation, Unknown, Other.
OrgRoleAsset
Potential roles that might played by an organisation relative to an asset.
percentOwnership
If the role type is 'owner,' this indicate the percentage of ownership.
Rating
Rating is a name-value pair concept that provides the means for utilities to describe various myriad ratings for a given asset, asset type (AssetModel), or other object that is not included in the standard model.
ratingType
property
Describes what is the rating means e.g. '3PhaseAmps', 'KVA' etc(propertyName,description).
ratingValue
Value holds the actual value of the rating for the associated object and can be used to set the initial value of operational MeasurementLimits.
AssetGrouping
User defined category for various purposes like maintenance, inspection, etc. For example, an AssetGrouping is used to specify fixed asset group.
AssetGroupingRole
Potential roles that might played by an AssetGroup relative to an Asset.
QualificationRequirement
Certain skills are required and must be certified in order for a person (typically a member of a crew) to be qualified to work on types of equipment.
qualificationID
OrgPsrRole
Potential roles that might played by an organisation relative to a type of PowerSystemResource.
AssetAssetRole
Potential roles that might played by an asset relative to a another asset.
FailureEvent
An event, a type of ActivityRecord, where an asset has failed to perform its functions within specified parameters.
failureCode
isolationMethod
How the asset failure was isolated from the system: Breaker Operation, Fuse, Burned in the clear, Manually Isolated, Other.
faultLocatingMethod
The method used for locating the faulted part of the asset. For example, cable options include: Cap Discharge-Thumping, Bridge Method, Visual Inspection, Other.
locationOfFailure
DocAssetRole
Potential roles that might played by a document relative to individual assets.
AssetList
A type of collection, an Asset List is list of physical assets. It is similar to an Equipment List, which is a list of logical equipment.
Dimensions
As applicable, the basic linear, area, or volume dimensions of an asset, asset type (AssetModel) or other type of object (such as land area).
sizeUnits
sizeLength
sizeDepth
sizeWidth
sizeDiameter
orientation
A description of the orientation of the object relative to the dimensions. As an example, a vault may have north-south orientation for the sizeLength measurement and sizeDepth may be the height of the vault.
AssetCatalogue
An Asset Catalogue documents collections of existing or available types of equipments that are used to build or install an Asset(s), to maintain an Asset(s) or to operate an Asset(s).
AssetWorkTrigger
Asset maintenance and inspection package.
Interval
An interval defines a time period for measurements. This is used, for example, by Interval Meters. An interval meter supports multiple intervals, providing separate measurements for each one. Different rates may apply for each interval.
The time interval specified in seconds. A device like a meter may have multiple interval resolutions (e.g., 1, 5, 15, 30, or 60 minutes).
offset
The offset from midnight (i.e., 0 hours, 0 minutes, 0 seconds) for the interval to begin.
DiagnosisDataSet
The result of a problem (typically an asset failure) diagnosis, which is a type of Procedure.
preliminaryCode
Code for problem category determined during preliminary assessment.
preliminaryRemarks
Remarks pertaining to preliminary assessment of problem.
preliminaryDate
Date and time preliminary assessment of problem was performed.
finalCode
finalRemarks
Remarks pertaining to findings during problem diagnosis.
finalCause
Cause of problem determined during diagnosis.
finalOrigin
Origin of problem determined during diagnosis.
finalDate
rootCause
Root cause of problem determined during diagnosis.
rootOrigin
Root origin of problem determined during diagnosis.
rootRemarks
Remarks pertaining to root cause findings during problem diagnosis.
effect
phase
failureMode
Failuer mode, for example: Failure to Insulate; Failure to conduct; Failure to contain oil; Failure to provide ground plane; Other.
TestDataSet
Test results, usually obtained by a lab or other independent organisation.
specimenID
Identifier of specimen used in inspection or test.
conclusion
specToLabDate
The date the specimen was received by the lab.
conclusionDate
The date the conclusion form the test was issued by the lab.
PointAssetHierarchy
SwitchAssetModel
An switch asset is the physical asset used to perform the switch's role. It is associated with Switch of the Wires Package.
gang
True if multi-phase switch controls all phases concurrently.
remote
True if device normally operated by remote control.
interruptingRating
Breaking capacity, or short circuit rating, is the maximum rated current which the device can safely interrupt at the rated voltage.
Pole
treatment
Pole treatment: Full, Butt, Natural, Gray Stain, Green Stain, Penta, Other, Unknown.
base
Pole base: Asphalt, Cement, Dirt, Other, Unknown.
preservative
Pole preservative: Creosote, Cellon, Naphthena, Penta, Chemonite, Other, Unknown.
treatedDate
Date pole was last treated with preservative.
breastBlock
True if a block of material has been attached to base of pole in ground for stability. This technique is used primarily when anchors can not be used.
Streetlight
rating
armLength
Tool
A tool is a type of utility asset typically used by utility resources like crews and persons (ErpContacts). As is the case for other assets, tools must be maintained.
lastCalibrationDate
Date the tool was last caibrated, if applicable.
UGStructure
Underground Structure. Typical structure types are: BURD, Enclosure, Hand Hole, Manhole, Pad/Slab, Subsurface Enclosure, Trench, Tunnel, Vault, Pull/Splice Box.
ventilation
sealingDate
sealingWarrantyExpires
typeName
Name of underground structure type: BURD, Enclosure, Hand Hole, Manhole, Pad/Slab, Subsurface Enclosure, Trench, Tunnel, Vault, Pull/Splice Box.
Vehicle
Structure
height
weedAbate
True if weeds are to be removed around asset.
weedRemDate
fumigant
fumigantApplyDate
jpaRefNum
Manhole
A manhole provides access at key locations to underground cables, equipment, etc. housed inside a protective vault.
CabinetModel
ElectricalAssetModel
A device asset is the physical asset used to perform the conducting equipment's role. It is associated with ConductingEquipment of the Wiresl Package
ratedVolts
ratedAmps
bil
Basic Insulation Level (BIL) for switchgear, insulators, etc.A reference insulation level expressed as the impulse crest voltage of a nominal wave, typically 1.2 X 50 microsecond. This is a measure of the ability of the insulation to withstand very high voltage surges.
frequency
Frequency at which stated device ratings apply, typically 50 Hz or 60 Hz.
MeterAssetModel
Types of meters used to measure power consumption by customers. They are associated with CustomerMeter of the LoadModel Package.
regRatio
noWires
noDials
form
MeterAsset
The MeterAsset is the physical device that perform the role of the CustomerMeter.
sealNo
kWCMultiplier
Meter kWC (pulse) multiplier. Meter Multiplier Value is used as a multiplier for a Meter Register Reading to determine the actual amount of usage for which to bill a customer.
kWhMultiplier
Meter kWh Multiplier. Meter Multiplier Value is used as a multiplier for a Meter Register Reading to determine the actual amount of usage for which to bill a customer.
demandMultiplier
Meter demand multiplier. Meter Multiplier Value is used as a multiplier for a Meter Register Reading to determine the actual amount of usage for which to bill a customer.
password
PoleModel
A type of pole. A pole is a long, slender piece of wood, metal, etc. usually rounded that stands vertically from the ground and is used for mounting various types of overhead equipment.
species
Pole species. Aluminum, Aluminum Davit, Concrete, Fiberglass, Galvanized Davit, Galvanized, Steel Davit Primed, Steel Davit, Steel Standard Primed, Steel, Truncated, Wood-Treated, Wood-Hard, Wood-Salt Treated, Wood-Soft, Wood, Other, Unknown.
classification
Pole class: 1, 2, 3, 4, 5, 6, 7, H1, H2, Other, Unknown.
JointAsset
A joint connects two or more cable assets. The joint includes the portion of cable under wipes, welds, or other seals.
configuration
Configuration of joint. Examples include: 3 Wire to 1 Wire, 2 Wire to 1 Wire, 1 Wire to 1 Wire, Other.
fill
Material Used to fill the joint. Examples include: No fill-prefab joint, Air-no filling, Petrolatum, Asphaltic, Oil, 254 Bluefill, No-Void, Epoxy, Insoluseal, Other.
LinearAssetHierarchy
DuctBank
A duct bank may contain many ducts. Each duct contains individual lines that are expressed as linear assets (thereby describing each line's physical asset characteristics), which are each associated with ACLineSegments and other classes describing their electrical characteristics.
numDucts
numCircuits
Number of circuits in duct bank. Refer to associations between a duct (LinearAsset) and an ACLineSegment to understand which circuits are in which ducts.
StructureSupport
Anchors and Guys are types of Support for Structures ('anchor' or 'guy' should be specified in the 'type' field inherited from Asset). Anchors are used to hold poles secure. Anchor type may be concrete, helix, multi-helix, rod, screw, other, unknown.
size
direction
Direction, specified in degress, of supporting anchor or guy.
numRods
rodLength
LinearConductorAsset
A conductor asset is the physical asset used to perform the conductor's role.
insulated
Condition is true if linear asset has an insulator around the core material.
Orientation of conductor: 0=horizontal (e.g., transmission and distribution lines); 1=vertical (e.g. a riser for underground to overhead service).
CableAssetModel
Characteristics of a type of physical cable.
insulationType
Type of insulation material. Examples include: Asbetos & Varnished cambric, Butyl, EPR, HMWPE, Low Capacitance rubber, TRHMWPE, Oil Paper, Ozone resistant rubber, PILC - Belted, PILC - Unbelted, Rubber, Silicon Rubber, Varnished cambric cloth, Varnished dacron glass, XLPE-Crosslinked polyethylene, TRXLPE, Other
insulationThickness
insulatingCompound
outerJacket
Null if cable does not have an outer jacket. Otherwise, type of jacket is provided. Examples include: Linear Low-density Polyethylene, PVC, Polyethylene, Insulating, Semiconducting, Other.
neutralCondDesign
Neutral Conductor Design: Concentric Neutral, Copper Tape, Aluminum Tape, Lead insulation, Other.
strandFillFlag
True if wire strands are extruded in a way to fill the voids in the cable.
nominalTemp
Maximum Nominal design operating temperature.
conductorMaterial
Type of conductor material: Aluminum, Copper, Other.
sheathMaterial
Sheath material: Lead, Copper, Steel, Aluminum, None.
sheathNeutral
construction
Type of construction: Compacted, Compressed, Sector, Segmental, Solid, Stranded, Other.
shieldType
Type of conductor shield: Freeform, Supersmooth, Conventional, Superclean, Other.
Consumer
This package is used to define detailed customer models as are needed for 61968.
WorkBillingInfo
issueDate
dueDate
Date by which payment for bill is expected from client.
receivedDate
workPrice
costEstimate
deposit
discount
CustomerAccount
The CustomerAccount defines the assignment of a group of products and services purchased by the Customer through a CustomerAgreement. A CustomerAccount collects together the Service Agreements, Security Agreements, Contract Agreements, and Non-Service Agreeements to create billings(invoices) for a Customer and receive payment on those Agreements. It is used as a mechanism for customer billing and payment.
billingCycle
Billing cycle identifies cycle day on which the related Customer Account will normally be billed. It is used in determining when to produce the billing statement for the Customer Account.
budgetBill
status
Status of customer account: Active, Final, To Be Final (final bill has not been generated yet), Other
CustomerAgreement
The CustomerAgreement is an agreement between the Customer and the utility to pay for service at a specific ServiceLocation. The Service Agreement, a type of CustomerAgreement, records certain billing information about the type of service provided at the ServiceLocation. It is used during charge creation to determine the type of Service. CustomerAccount contains common information from the various types of ServiceAgreements.
typeAgreement
Type of Contract Agreement: Cost Based Service, Direct Access, Standard Offer, Emergency Default, Portfolio, Other. Note that availability of supply options is typically limited in accordance with the customer type (e.g., residential, commercial, industrial).
typeService
The type of service that supports the customer agreement: electric single-rate, electric time-of-use, streetlight, other.
PowerQualityPricing
normalHighVoltLimit
normalLowVoltLimit
emergencyHighVoltLimit
emergencyLowVoltLimit
valueUninterruptedServiceKW
Value of uninterrupted service (Cost per kW).
valueUninterruptedServiceKWh
Value of uninterrupted service (Cost per kWh).
voltLimitViolCost
Voltage limit violation cost (Cost per unit Voltage).
voltImbalanceViolCost
Voltage imbalance violation cost (Cost per unit Voltage).
powerFactorMin
This specifies the threshold minimum power factor for a Pricing Structure. It is specified in instances where a special charge is levied if the actual power factor for a Service falls below the value specified in this attribute.
Tariff
A document, approved by the responsible regulatory agency, listing the terms and conditions, including a schedule of prices, under which utility services will be provided. The Tariff has a unique number within the state or province. For Rate Schedules it is frequently allocated by the affiliated Public Utilities Commission.
Date tarrif was terminated. Value is null if tarrif is active.
SOLINE
The item or product ordered along with quantity, price and other descriptive information.
Customer
The Customer class is used to identify individual customers which are served electric power. Note that many of the typical fields describing the customer are defined in ERP classes. For example:The 'Partner' class contains 'partnrid' for customer ID, tax id, Dun & Bradstreet .(association role: Partner has zero to many Contacts)The 'ErpContact' class includes name, and references to telephone and fax number, e-mail address, etc.. about one or more individual associated with the customer account.
specialNeeds
Does overall customer (vs. ErpContact) have special service needs? Examples include life support, hospitals, etc.
vip
Is this an important customer, aside from any other special needs?
customerType
Type of customer. Examples include: residential, residential & commercial, residential & streetlight, residential-streetlight-others, residential-farm-service, commercial-industrial, pumping load,wind machine, energy service supplier, energy service scheduler, other, internal use.
pucNumber
Public Utility Commission identification number, if applicable.
StandardIndustryCode
The Standard Industrial Classification are the codes that identify the type of products/service an industry is involved in. For example, in the USA these codes are located by the federal government, and then published in a book entitled 'The Standard Industrial Classification Manual'. The codes are arranged in a hierarchical structure. It is used for statutory reporting purposes.Note that Residential Service Agreements are not classified according to the SIC codes.
SIC Code is a standard alphanumeric code assigned to a particular product/service within an industry.
ExternalCustomerAgreement
A type of customer agreement involving an external agency. For example, a customer may form a contracts with an Energy Service Supplier if Direct Access is permitted.
PricingStructure
A grouping of pricing components and prices used in the creation of customer charges and the eligibility criteria under which these terms may be offered to a customer. The reasons for grouping includes state, customer classification, site characteristics, classification (i.e. fee price structure, deposit price structure, electric service price structure, etc.) and accounting requirements.
Code is a unique user-allocated key for a Pricing Structure. It is used by company representatives to identify the correct price structure for allocating to a customer. For rate schedules it is often prefixed by a state code.
taxExemption
The Tax Exemption Indicator is the indicator that specifies whether the Pricing Structure is taxable or not. Yes=Taxable Pricing Structure, No=Non-Taxable Pricing Structure
dailyEstUsage
Daily Estimate Usage Quantity is a manually entered usage quantity typically entered by customer accounting. It is used in place of actual computed estimated average when history of usage is not available.
dailyCeilingUsage
Daily Ceiling Usage Quantity is the absolute maximum valid non-demand usage quantity used in validating a customer's billed non-demand usage.
dailyFloorUsage
Daily Floor Usage Quantity is the absolute minimum valid non-demand usage quantity used in validating a customer's billed non-demand usage.
revenueClass
Revenue Class is an accounting classification of the type of revenue collected for the Customer Agreement. It is typically used to break down accounts for revenue accounting. Typical classes include: Residential, Non-residential, Commercial, Industrial, Irrigation, Street Light, Other.Revenue Class is often used to determine the grace period allowed, before collection actions are taken on a customer. (grace periods vary between revenue classes)
CustomerBilling
The creation of the monthly Customer Billing Statement is the method employed to notify Customers of charges, adjustments and credits applied to their account for Services and Products. The Customer Billing Statement includes information from the payment, collection, meter reading, installed meter, service, site, customer, customer account, customer agreement, services and pricing subject areas. Each component price shows up as a separate line item on the ERP invoice, referred to as a Receivable.The Customer Billing Statement may include collection and account messages, marketing/civic event messages and bill inserts.One Customer Billing Statement is produced for all Agreements under a Customer Account per billing month.The Customer Billing Statement is produced on the billing cycle date assigned to a Customer Account.
billingDate
The business date designated for the billing run which produced the Customer Billing Statement.
Due Date contains the calculated date upon which the Customer Billing Statement amount is due. It is used to determine when a Customer's Payment is delinquent. This due date takes into consideration the regulatory criteria and the Customer's requested due date. In the absence of a Customer requested due date, this statement due date is typically calculated from the regulated number of days and the bill date of the Customer Billing Statement.
outBalance
This is the outstanding balance on the Customer Account as of the statement date.
billMedia
Bill Media contains a coded value that represents the media by which the Customer Billing Statement was delivered (Paper, EDI, Other).
pymtPlanAmt
This is the monthly amortized amount due during each billing cycle for the Customer Account balance for which the Payment Plan is set-up.
pymtPlanType
mailedDate
Used to indicate the date on which the customer billing statement was printed/mailed.
billingType
Customer receives a (1) consolidated bill from energy service supplier (ESS), (2) consolidated bill from utility distribution compnay (UDC), (3) separate bills from ESS and UDC, (4) other.
lastPaymentDate
The details of each payment are tracked in the ERP system. However, the date of the last payment received from the customer is retained in CustomerBilling.
lastPaymentAmt
The details of each payment are tracked in the ERP system. However, the amount of the last payment is maintained in CustomerBilling.
CustomerList
Generic part of a document containing references to many Customers. Could be list of connected customers or list of affected customers.
Core2
The Core2 Package contains core functions needed for distribution management. These core extensions were not sufficiently mature to standardize at the time IEC61970-301 was released as a draft standard, and therefore Core2 is being released as part of IEC 61968-11. As is the case of the Core Package, these classes and relationships are intended to be used throughout the CIM.
ActivityRecords
ActivityRecord
An ActivityRecord records activity for an Asset, Location, PowerSystemResource, Customer, ErpContact (e.g., operator, market participant, etc.), or other object at a point in time. An activity may be for an event that has already occurred or for a planned activity.The PowerSystemResource relationship records events regarding the logical function being provided by the resource in the electrical network (independent of the particular asset providing the function). The Asset relationship records history about the particular equipment, independent of where it is currently being used in the electrical network. The Location relationship records events associated with the geographical location. The Customer relationship records history regarding the customer independent of the logical network or particular assets being used to serve the customer.Future state activities are used, for example, when generating units must be scheduled for maintenance or when a transformers is scheduled to be refurbished.
Status at the time of 'statusDate.' For an asset, this is new construction (installed, ready to be placed in operation), in-service, decommissioned (out-of-service), removed, existing, proposed abandoned, proposed install, proposed remove, proposed replace, unknown, other.
statusReason
Reason code or explanation for why object went or is planned to go to this status.
remarks
Text that was recorded at the time specified in 'createdOn.'
planned
This flag is set true if status is for a planned activity (vs. an activity that has actually occurred).
History
List of Documents and/or Events which form a history.
Domain2
CoordinatePair
xPosition
yPosition
gml_Feature
Feature is used for rendering of an object.To facilitate the economic use of widely available graphical tools and applications, the Geography Markup Language (GML) is intended to be used for the management of graphical information. GML is an XML grammar written in XML Schema for the modelling, transport, and storage of geographic information. It was created by the Open GIS Consortium and is standardized through ISO.
PointSequence
A PointSequence is a sequence of x/y coordinate pairs for providing the physical location of non-point oriented objects like Cables, Ducts, etc. or for describing an area of an object. '
Location
ElectronicAddress
lan
email
web
radio
The place where someone or something is at a given moment.
The type of location: geographical, functional accounting, other.
A codified representation of the location.
coordinate
x and y coordinates associated with location
belongs to location
coordinateList
A PointSequence is a sequence of x/y coordinate pairs for providing the physical location of non-point oriented objects like Cables, Ducts, etc. or for describing an area of an object like a substation or georgraphical zone. These coordinates are used to define the centroid coordinate, which is specified in the 'coordinate' attribute.
Member of coordinateList
polygonFlag
Flag is true if the first and last point in the coordinate list are to be connected, thus forming a polygon rather than merely a sequence of line segments.
LocationGrant
A grant provides a right, as defined by type, for a parcel of land.
grantType
signDate
Date that the Parcel Owner signed acknowledgement of the grant.
grantDate
propertyData
Property related information that describes the Grant's land parcel. For example, it may be a deed book number, deed book page number, and parcel number.
RightOfWay
A right-of-way (ROW) is for land where it is lawful to use for a public road, an electric power line, etc.
rightOfWayType
date
Property related information that describes the ROW's land parcel. For example, it may be a deed book number, deed book page number, and parcel number.
ServiceLocation
Service location. For residential or most businesses, it is typically the location of the meter on the utility customer's premises. For transmission, it is the point(s) of interconnection on the transmission provider's transmission system where capacity and/or energy transmitted by the transmission provider is made available to the receiving party. The point(s) of delivery is specified in the Service Agreement.
servType
loadMgmt
occupancyDate
Date certificate of occupancy was provided for this location. Value is zero if a valid certificate of occupancy does not exists for this location Service location code.
accessMethod
The method for the service person to access the appropriate service locations. For example, a description of where to obtain a key if the facility is unmanned and secured.
Site
An area or plot of ground on which anything has been, is, or will be located.
demographic
Demographics around the site, for example, rural or urban.
siteType
The siteType attribute may take one of the following string values.Building: A site enclosed within a building.CustomerPremise: A site with a customer.Depot: A storehouse for supplies that also serves as a station for supporting crews.Store: A place of storage (e.g., a warehouse) to put aside, or accumulate, material and equipment for use when needed.Substation: A transmission network switchyard.GridSupplyPoint (GSP): a substation where the distribution and transmission networks meet and hence have mixed ownership and mixed operational control.
Zone
An area that is divided off from other areas. It may be part of the electrical network, a land area where special restrictions apply, weather areas, etc. For weather, it is an area where a set of relatively homogenous weather measurements apply.
zoneType
Type of zone: electrical network, special restriction on land area, weather zone, other.
Directions
Directions for navigating from one location to another location, typically driving directions.
directions
Route
A route that is followed, for example by a service crews and meter readers.
TopLevel
Organisation
This class is used to identify organisations that might have roles as utilities, contractors, suppliers, manufacturers, etc. Organisations may also have parent-child relationships to identify departments within an organisation, or parent company relationships.
Status of this organisation (e.g., planned, open, closed, other).
costCenterFlag
Flag is true if organisation is a cost center.
profitCenterFlag
Flag is true if organisation is a profit center.l
mode
The operational mode of the organisation. Some utilities use text to describe various modes like nominal, emergency, storm, other. Other utilities use severity ratings where, for example, 0 is a nominal condition and 5 is the most severe condition. This information is often required for outage reporting purposes.
OrgErpContactRole
Potential roles that might played by a person (contact) relative to an organisation.
OrgLocationRole
Potential roles that might played by an organisation relative to a location.
DocErpContactRole
Potential roles that might played by a person (contact) relative to a particular document.
OrgOrgRole
The relationship role of one organisation to another organisation. This includes role ups for ogranisations, cost centers, profit centers, regulatory reporting, etc.The parent and child relationship is indicated by the name on each end of the association.
DocOrgRole
The relationship role of one organisation to documents, a key type of document being work.
SkillCertification
A record of the set of skills needed to operate or maintain a particular type of asset
dateCertified
Collection
Class for management of dynamic aggregation.
collectionType
collectionQuantity
Crew
A crew is a collection of people (ErpContacts) with specific skills, tools, and vehicles.
Agreement
A formal agreement between two parties defining the terms and conditions for a set of services. The specifics of the services are, in turn, defined via one or more service agreements.
agreementStatus
DocDocRole
Potential roles that might played by a document relative to another document.
Role
This is an enumeration of potential roles that might played by one object relative to another.
privilege
roleType
Presentation
GML is used for rendering objects on various types (geographic, schematic, other) of displays and maps associated with various coordinate systems.
rendering
Particular attributes to be rendered in GML.
Diagram
Documentation
The Documentation Package contains sub-packages (themes) for real world objects that are largely document oriented (e.g., Work Order, Trouble Ticket, Safety Document, etc.).
DataSetsPackage
EquipmentList
A generic set of PowerSystemResources with common states or characteristics. The purpose of this class is to avoid a large number of relationships with PowerSystemResource for different Documents. Examples of 'type' of Equipment List (inherited from Document) include: planned, actual, other.
topologyState
One of 'Open', 'Closed', 'Unknown','ApplyEarth'. This is particularly applicable to lists of isolation points or lists of earth points.
energizedState
One of 'Live', 'Earthed', 'Dead', 'Faulted', 'Unknown'. This is derived from topology processing and is particularly applicable to lists of affected supply points.
NetworkChangeSet
A special type of NetworkDataSet. The equipment, symbol placement, connectivity and parameter data is either deleted if the equipment Id is in the delete list, updated if the Id is in the update list or inserted if not on either delete or update list.
NetworkDataSet
Categorized as a type of document, a network data set is a model of a portion of the electrical network that includes a list of the equipment, along with relevant connectivity, electrical characteristics, geographical location, and various parameters associated with the equipment.
LandBase
LoadDataSet
Customer, supply point or area load data. May include Meter records for customers (where regulations allow).
ConductorCatalogue
A list of ConductorTypes. This is reference data that does not change as often as the network.
Feeder
A static collection of conducting equipment originating at a main distribution center and supplying one or more secondary distribution centers, one or more branch-circuit distribution centers, or any combination of these two types of equipment.
MachineCatalogue
A list of generic SynchronousMachine types.
OperationalPackage
OperationalRestriction
An Operational Restriction is a type of document that can be associated with a device to describe any sort of restrictions compared with the original manufacturer's specification e.g. temporary maximum loadings, maximum switching current, do not operate if bus couplers are open etc etc.In the UK, for example, if a breaker or switch ever mal-operates, this is reported centrally and utilities use their asset systems to identify all the installed devices of the same manufacturer's type. They then apply operational restrictions in the operational systems to warn operators of potential problems. After appropriate inspection and maintenance, the operational restrictions may be removed.
endDateTime
restriction
SafetyDocument
A safety document is used during the course of work on the electrical system for safety purposes. There are many types of safety documents that could be defined based upon organisational practices.Note: ClearanceTag is a special case of a Safety Document.
ScheduleStep
A single step within a SwitchingSchedule. Could be a switching operation, applying a network alteration or issuing a safety document.Note: Inherited name from Naming.name is used to hold Sequence Number.
requiredControlAction
Control actions required to perform this step.
requiredDocStatus
status of document to be issued or canceled.
instructedDateTime
completedDateTime
text
SwitchingSchedule
A switching schedule is a document which identifies a sequence of switching operations which are to be performed on the electrical distribution network. For example, a set of steps to isolate an item of plant with regard to safety, equipment ratings, and standards of customer service.Note 1: that this (IEC 61968) SwitchingSchedule is intended to describe the full operational details for switching for real time operation which includes other operations such as grounding, applying safety documents etc.Note 2: The association to ErpContact suits the UK practice of quoting specific names (e.g the crew foreman). The association to Crew is for US practice.
ErpContactScheduleStepRole
Potential roles that might played by a person (ErpContact) relative to a particular ScheduleStep.
OutagePackage
OutageRecord
A document describing details of an outage in part of the electrical network. Typically produced by a SCADA system following a breaker trip or within a Trouble Call System by grouping customer calls. This has an associated OutageStep for each supply point.In some countries all outage restoration is performed using a SwitchingSchedule which complements the OutageRecord and records the ErpContacts (crew) and any planned Work. In other systems, it may be acceptable to manage outages including new WorkTasks without switching schedules.Note: The relationship between OutageRecord and ErpContact and Crew is inherited as each is a type of Document.
outageType
Type of outage, often express as a cause code. While many cause codes may be applicable to a given outage, the primary cause in captured here.
Time restoration was completed for all customers impacted by this outage.
isPlanned
false if unplanned, for example due to a breaker trip.
date and time first customer went off-supply
Current status of the overall outage. Note that each status change is recorded in an associated Activity Record.
actionTaken
Overall action taken to resolve outage. Reference associated work tasks for details.
damageCode
The damage code relative to the associated PowerSystemResource(s) and/or Asset(s). Examples include broken, burnout, failure, flashed (burned), manually operated, wire down, no damage - rolling blackout, none.
The value of Organisation.mode at the time of OutageRecord.startDateTime. Some utilities use text to describe various modes like nominal, storm, emergency, other. Other utilities use severity ratings where, for example, 0 is a nominal condition and 5 is the most severe condition. This information is often required for outage reporting purposes.
OutageReport
A document describing the statistics related to an outage.
totalCustomers
Number of customers for the Outage Record
totalDuration
aveCustomerMinsLost
The average cusotmer minutes of interruption for this outage.
totalCustomerMinsLost
OutageStep
Holds an Outage History (start time, end time) for each supply point of an outage record. The supply point for a given step is the associated PowerSystemResource instance.
offDateTime
onDateTime
jobPriority
numberTotalCustomers
Number of customers connected to the PowerSystemResource.
numberSpecialCustomers
Number of customers with high reliability required.
numberCriticalCustomers
Number of customers with critical needs, e.g., with a dialysis machine.
numberCallers
fatality
Fatalities reported by caller or engineer? Y/N/Null
injury
Injuries reported by caller or engineer? Y/N/Null
shocks
Shocks reported by caller or engineer? Y/N/Null
damage
Damage reported by caller or engineer? Y/N/Null
estRestoreDateTime
averageCustMinIntrpt
The average cusotmer minutes of interruption for this supply point for this outage.
customerMinutesLost
Total minutes of customer interruption for this supply point for this outage.
OutageCode
Classification of outage types. Multiple outage codes may apply to a given a given outage or outage step. The primary overall outage type is recorded in OutageRecord.outageType. There may be more than one classification per outage step and/or per outage record.Example codes/subcodes include: weather/ice, weather/lightning, wildlife/squirrel, wildlife/bird, burned/overload, burned/weather, wire down/accident, wire down/tree, wire down/vandalism, etc.The typical 'outage code' is in the inherited 'name' attribute. The code is described in the inherited 'description' attribute.
subCode
The main code is stored in the inherited .name. This sub-code provides an additional level of classification detail.
OutageStepPsrRole
Potential roles that might played by a PowerSystemResource relative to a OutageStep. Examples roles include: normal supply, actual supply, interrupting device, restoration device.
TroubleTicketPackage
TroubleTicket
A trouble ticket is a document which is used to report electrical trouble. The trouble may either be an outage or non-outage problem, such as power quality.
typeOfTrouble
Code which describes the type of trouble.
timeOfCall
Time trouble call first received. The time of subsequent calls by the same customer for the same trouble are recorded in associated Activity Records.
priority
restorationTime
Time of restoration of resolution of trouble.
numberCalls
Number of call made by a customer regarding this particular trouble ticket.Note that a separate Activity Record is created for each call, wher the time of the call is stored in ActivityRecord.createdOn and comments are recorded in ActivityRecord.remarks.
hazardCode
callBackERT
Flag set true if person reporting trouble requested a call back when sigificant information became available about cause of the outage and the estimated restoration time. The person and their contact information is maintained in the assoicated Customer informaiton. Call back results are recorded in an assoicated ActivityRecord.remarks.
callBackRestore
Flag set true if person reporting trouble requested a call back when to confirm power has been restored. The person and their contact information is maintained in the assoicated Customer informaiton. Call back results are recorded in an assoicated ActivityRecord.remarks.
PlannedOutage
A planned outage involves network operations which will affect the supply of power to customers.
OutageNotifice
A document containing information to be sent to customers notifying that an outage will take place. This is used to generate mailing lists for customers.
DocumentInheritancePackage
General package for document inheritance.
Document
Parent class for definition of document subclasses. Documents are units of information exchange. Documents will frequently contain references to other objects, such as assets, people and power system resources.
lastModified
Time and date the document was last modified. Documents may potentially be modified many times during their lifetime.
comments
docStatus
revisionNumber
subject
Main subject for this type of document. Sometimes referred to as a document subtype.
title
subjectStatus
Status of object or activity that is the main subject matter of this document.
subjectStatusDate
Date and time when 'subjectStatus' was recorded.
ERP_Support
The Enterprise Resource Planning (ERP) Support Package contains portions of the model defined by ERP standards like those proposed by the Open Applications Group (OAG). This package is provided to facilitate integration among electric utility applications (CIM) and enterprise resource planning (ERP) applications (OAG). Rather than inventing new CIM classes that accomplish similar functionality as in existing ERP models, the preferred approach is to use and extend ERP classes as appropriate in other packages.If a model other that the OAG standard is used as a basis for ERP integration, the utility classes labeld 'Erp...' should be associated with the appropriate classes of that standard.
ErpSalesOrder
General purpose Sales Order is used for utility service orders, etc.This is used by ERP applications to facilitate transfer of sales or customer order information between separate data bases throughout an enterprise. This can be for the adding of new sales orders and the modification of previously established sales orders.
ErpAddress
General purpose address information used for utilities. Where sufficient, fields are used from the ERP model. However, to support additional querying that is typical of utilities, the address line is broken into more specific fields.
streetNumber
The designator of the specific location on the street.
streetName
streetSuffix
Suffix to the street name. For examle, North, South, East, West.
streetPrefix
Prefix to the street name. For examle, North, South, East, West.
streetType
Type of street. Examples include: street, circle, boulevard, avenue, road, drive, etc.
poBox
suiteNumber
addressGeneral
Additional address information, for example a mailstop.
townCode
section
A Section is part of a township. For example, it is common for there to be 36 section per township.
city
stateOrProvince
country
postalCode
ErpPartner
General purpose information regarding a utility partner. For example, the OAG specifies this is to be used by ERP applications to represent the business partner. Several examples of PARTNERS are those business partners that products are sold to, bought from, or delivered by.
partnerTypeQualifier
Qualifier for PARTNER.PARTNRTYPE (component of ErpPartner). Examples include utility enterprise, division, business unit, department, energry service supplier, energy service scheduler, manufacturer, contractor, governmental agency, supplier, etc.
marketRole
optOut
This field indicates whether or not the organisation has requested that their contact information not be shared with other organisations for purposes of solicitation, often referred to as 'opting out.' false (0) = okay to solicit; true (1) = opted out.
ErpContact
General purpose utility information for name and other information to contact people associated with the ErpPartner.
lastName
Last name, company name if non-residential.
firstName
mName
Middle name or initial (if residential).
Special service needs for the person (contact) are described; examples include life support, etc.
ErpPersonnel
Information that applies to the basic data about a utility person. This is used by ERP applications to transfer Personnel data for a worker.
ErpCompetency
Information that describes the skills of the utility employee.
ErpSiteLevelData
For a utility, general information that describes physical locations of organizations or the location codes and their meanings.This enables ERP applications to ensure that the physical location identifiers are synchronized between the business applications.
ErpInventory
Utility inventory related information about an item or part. This data type is not for describing the item and its attributes.This is used by ERP applications to enable the synchronization of Inventory data that exists on separate Item Master databases. This data is not the master data that describes the attributes of the item such as dimensions, weight, or unit of measure. This is data that describes the ITEM as it exists at a specific location.
ErpIssue
General information about the items that may be issued by a utility.This is used by ERP applications to transfer item issue information against an order, between an ERP system and a PDC system to confirm the item issue transaction. The environment for this integration is from Plant Data Collection Systems to Enterprise Business Application Systems.
ErpPayable
Information that applies to the entire payable document for a utility.This supports transfer data between payable open items in a payables application and the purchasing information generated in a purchasing application. It also update the General Ledger, depending on the specific architecture of the financial applications
ErpProjectAccounting
Utility Project Accounting information.This is used by ERP applications to enable all relevant sub-systems that submit single sided transactions to transfer information with a Project Accounting Application. This would include, but not necessarily be limited to:·Accounts Payable·Accounts Receivable·Budget·Order Management·Purchasing·Time and Labor·Travel and Expense
ErpBOM
Information that generally describes the Bill of Material Structure and it's contents for a utility.This is used by ERP systems to transfer of Bill of Material information between two business applications.
ErpRequisition
General information that applies to a utility requisition.
ErpChartOfAccounts
Information that applies to the chart of account data for a utility.
ErpProductInspection
Information that corresponds to the item or product specific inspection information.This supports the supply of inspection information for goods or services from one business application module to another.
ErpEngChangeOrder
General Utility Engineering Change Order information.
ErpInventoryCount
This is related to Inventory physical counts.It enables ERP applications to transfer an inventory count between ERP and the actual physical inventory location. This count may be a cycle count or a physical count.
ErpJournalEntry
Utility Journal and Journal Entry information. . This supports the transfer journal entry data between any sub ledger business application and a general ledger application.
ErpLedgerBudget
This is for information for utility Ledger Budgets. They support the transfer budget amounts between all possible source applications throughout an enterprise and a general ledger or budget application.
ErpPurchaseOrder
Purchase Order is a utility document authorizing the purchase of goods or services from a specific vendor. The purchase order includes the terms of the purchase, delivery requirements, identification of goods or services ordered, as well as their quantities and prices.
ErpReceivable
Receivable is a transaction representing an invoice, credit memo or debit memo to a utility customer. A receivable is an open (unpaid) item in the Accounts Receivable ledger.The purpose is for ERP systems to be able to transmit data to create a receivable open item in a receivable application from the billing information generated in an order management application. It may also be used to update the General Ledger, depending on the specific architecture of the accounting application.
ErpWorkSchedule
Work Schedule represents ERP data related to the planned work hours for an utility employee. A work schedule typically includes relatively static employee information, such as employee ID and name. It will also include schedule-specific information such as dates and amount of time to be worked.
ErpMaintenanceOrder
Maintenance Order information managed by an ERP system.
ErpAmount
Used to communicate monetary data between applications.
ErpBomItemData
An individual item on a bill of materials.
ErpTelephoneNumber
The telephone number for a person or organisation.
countryCode
The country code for the telephone number.
areaCode
The area or region code for a telephone number.
cityCode
The city code, if applicable, for a telephone number.
localNumber
The main (local part of a) telephone number.
extension
The extension, if applicable, for a telephone number.
The purpose of the telephone: home, mobile, home fax, office, office fax, switchboard, other.
ErpItem
Item represents any unique purchased part for manufactured product tracked by ERP systems for a utility.Item, as used by the OAG, refers to the basic information about an item, including its attributes, cost, and locations. It does not include item quantities. Compare to the 'Inventory,' which includes all quantities and other location-specific information.
Work
WorkClosing
ContractorItem
activityCode
Activity code identifies a specific and distinguishable unit of work.
bidAmount
The amount that a given contractor will charge for performing this unit of work.
cost
LaborItem
laborHours
The number of hours required to perform work.
laborRate
Total cost for labor. Note that this may not be able to be derived from labor rate and time charged.
Overhead
PropertyUnit
Unit of property for reporting purposes.
materialCode
costCode
propertyAccount
WorkCostDetail
A collection of all of the individual cost items collected from multiple sources.
amount
Amount in designated currency for work, either a total or an individual element. As defined in the attribute 'type,' multiple instances are applicable to each work for: planned cost, actual cost, authorized cost, budgeted cost, forecasted cost, other.
debitFlag
True if 'amount' attribute is a debit, false if it is a credit.
transactionDate
CostType
A categorization for resources, often costs, in accounting transactions. Examples include: material components, building in service, coal sales, overhead, etc.
A codified representation of the resource element.
level
The level of the resource element in the hierarchy of resource elements (recursive relationship).
amountAssignmentFlag
True if an amount can be assigned to the resource element (e.g., building in service, transmission plant, software development capital); false otherwise (e.g., internal labor, material components).
stage
The stage for which this costType applies: estimated design, estimated actual or actual actual.
WorkCostSummary
A roll up by cost category for the entire cost of a work order. For example, total lablor.
VehicleItem
WorkDesign
DesignLocationCU
Compatible Unit at a given design location.
CompatibleUnit
A compatible unit is a pre-planned job model containing labor, material, and accounting requirements for standardized job planning.
Design
A design for consideration by customers, potential customers, or internal work.Note: 'Type', which is an attribute that is inherited from Document, is for design type: Estimated, As-built, Other.Version of design is the revision attribute that is inherited from Document.
price
Price to customer for implementing design.
DesignLocation
A logical part of the design (e.g., pole and all equipment on a pole). This includes points and spans.
WorkTask
A set of tasks is required to implement a design.
sequence
The sequence number to specify work task dependencies.
MiscCostItem
Various cost items that are not associated with compatible units.
NonStandardItem
This document provides information for non-standard items like customer contributions (e.g., customer digs trench), vouchers (e.g., credit), and contractor bids.
CUTask
An individual task to implement a compatible unit design.
totalHours
Total amount of effort (specified in hours) to perform task.
WorkInitiation
Work is a document which is used to request, initiate, track and record work.This is synonymous with Work Breakdown Structure (WBS), which is traversed through the recursive association of Work.Note that the work name is equal to the WBS name, which is given in the inherited 'name' attribute. At the sub-work level (through recursion), the inherited 'type' attribute indicates whether the work is capital, operations and maintenance, or other.
requestDate
typeWork
Type of work: construction, inspection, maintenance, service, misc.
Project
A collection of related work. For construction projects and maintenance projects, multiple phases may be performed.
budget
BusinessCase
Business justification for capital expenditures, usually addressing operations and maintenance costs as well.
A codified representation of the business case (i.e., codes for highway relocation, replace substation transformers, etc.).
Request
Schedule
Schedule and status for an activity that is to occur, is occurring, or has completed.
scheduledStartDate
plannedStartDate
plannedFinishDate
earliestStartDate
Estimated date for earliest possibility of work initiation.
latestFinishtDate
Estimate for latest date work should be completed.
actualStartDate
actualFinishtDate
workCompletedDate
Date all work associated with this Work Order was completed. Refer to Asset.installationDate for individual assets.
dayOfMonth
For monthly activities, a number denoting the working day in a month when something is to be performed. For example, the meters within a Meter Route are to be read. There are 21 working days in a accounting month and these are assigned to a specific date within the calendar month. The Meter Reading Cycle valid range of values is 1 to 21.
periodDays
The amount of time in a periodic cycle, specified in number of calendar days (vs. working days).
WorkFlow
A pre-defined set of work steps for a given type of work.
The sequence number is used to defined dependencies of each work flow step.
WorkSchedule
MaterialItem
AccessPermit
A permit is sometimes needed to provide legal access to land or equipment. For example, local authority permission for road works.
permitID
permitType
Type of permit. Examples include pole, electrical underground, etc.
applicationNumber
Permit application number that is used by municipality, state, province, etc.
expirationDate
payment
Regulation
Special requirements and/or regulations may pertain to certain types of assets or work. For example, fire protection and scaffolding.
regulationID
regulationType
Type of regulation. Examples include fire protection and scaffolding.
referenceNumber
External reference to regulation, if applicable.
UtilityRequisition
A written request or order for materials.
quantity
deliveryDate
OneCallRequest
A request for other utilities to mark their underground facilities prior to commencement of construction and/or maintenance.
WorkInspectionMaintenance
MaintenanceDataSet
The result of a maintenance activity, a type of Procedure, for a given attribute of an asset is documentated in an MaintenanceDataSet.
maintCode
Code for the type of maintenance performed.
conditionBefore
Description of the condition of the asset just prior to maintenance being performed.
conditionAfter
Condition of asset just following maintenance procedure.
maintDate
Date and time maintenance procedure was completed.
InspectionDataSet
The result of one inspection, a type of Procedure, for a given attribute of an asset is documentated in an InspectionDataSet.
Status of this attribute of the object for the time & date stated in inspectDate.
locationConditions
A general description of the conditions of the location where the asset resides.
inspectDate
Date and time this inspections was completed.
Procedure
A documented procedure for various types of Work or Work Tasks. The type of procedure is defined in Procedure.type. For example, when type=Inspection, this procedure coupled with Schedule and other information provides the key items of an inspection plan. Another type of Procedure is a Diagnosis. Note that each specific values and settings to be used in a procedure is intended to be described in an instance of ProcedureValue.A maintenance ticket, a type of Work, is generated whenever maintenance is determined to be needed as a result of an inspection or diagnosis.
The recommended periodicity for performing this same instance of procedure.
The sequence number in a sequence of procedures being performed.
proecdureText
The textual description of the procedure, which references instances of ProcedureValue as appropriate.
ProcedureValue
ProcedureValue is a name-value pair concept that provides the means for utilities to describe various values and settings to be used when performing proecdures on assets. An example is to have an instance for each of the following settings when conducting a test: voltage, current, frequency, temperature.
valueType
Describes what is the value means e.g. '3PhaseAmps', 'KVA' etc
Value holds the actual value of for the procedure,
WorkService
Appointment
startTime
The time at which the appointment begins.
endTime
The time at which the meeting is to be completed.
WorkStandards
CUContractorItem
CUGroup
A Compatible Unit Group identifies a set of compatible units which may be jointly utilized for estimating and designating jobs.
CULaborItem
the number of hours estimated to perform work.
CUMaterialItem
CUVehicleItem
Compatible unit for various types of vehicles.
rate
Standard usage rate for the type of vehicle.
CULaborCode
Labor code associated with various compatible unit labor items.
MarketOperations
RampRateCurve
Ramp rate as a function of resource MW output
rampRateType
How ramp rate is applied (e.g., raise or lower, as when applied to a generation resource)
Bid
Energy bid for generation, load, or virtual type for the whole of the market-trading period (i.e., one day in day ahead market or one hour in the real time market)
marketType
Market type (default =DA)DA - Day AheadRT - Real TimeHA - Hour Ahead
commodityType
Energy product (commodity) type:'En' - Energy'Ru' - Regulation Up'Rd' - Regulation Dn'Sr' - Spinning Reserve'Nr' - Non-Spinning Reserve'Or' - Operating Reserve
Bid operating mode ('C' - cycling, 'F' - fixed, 'M' - must run, 'U' - unavailable)
upTimeMax
Maximum Up time in number of trading intervals.
upTimeMin
Minimum Up time in number of trading intervals.
downTimeMax
Maximum Dn time in number of trading intervals
startUpsMax
Maximum number of startups per trading period
shutDownsMax
Maximum number of shutdowns per trading period
noLoadCost
startUpType
Resource startup type:1 - Fixed startup time and fixed startup cost2 - Startup time as a function of down time and fixed startup cost3 - Startup cost as a function of down time
Minimum amount of energy which has to be produced during the trading period in MWh
energyMax
Maximum amount of energy which can be produced during the trading period in MWh
startUpRampRate
BilateralTransaction
scope
transactionType
Transaction type (default 1)1 - Fixed2 - Dispatchable continuous3 - Dispatchable block-loading
Market type (default=DA)DA - Day AheadRT - Real TimeHA - Hour Ahead
purchaseTimeMin
Minimum purchase time in number of trading intervals
purchaseTimeMax
Maximum purchase time in number of trading intervals
curtailTimeMin
Minimum curtailment time in number of trading intervals
curtailTimeMax
Maximum curtailment time in number of trading intervals
totalTranChargeMax
Maximum total transmission (congestion) charges in monetary units
Pnode
A pricing node is directly associated with a connectivity node. It is a pricing location for which market participants submit their bids, offers, buy/sell CRRs, and settle.
beginPeriod
Start date-time of the period in which the price node definition is valid.
endPeriod
End date-time of the period in which the price node definition is valid
public
True=Public; False=PrivatePublic Pnodes: Prices are published for DA/RT and FTR Markets.Private Pnodes: Location is not usable by Market for Bidding/FTRs/Transactions
Price node type: Hub (H), Zone (Z), Control Area (C), …, Bus (B)
Price node usage:'Control Area''Regulation Region''Price Zone''Spin Region''Non-Spin Region''Price Hub'
StartUpCostCurve
Startup costs and time as a function of down time. Relationship between unit startup cost (Y1-axis) and unit startup time (Y2-axis) vs. unit elapsed down time (X-axis).
EnergyPriceCurve
Relationship between a price in $/hour (Y-axis) and a MW value (X-axis).
BidClearing
Bid clearing results posted for a given settlement period.
clearedMW
startUpCost
Start up cost in case of energy commodity in monetary units.
lostOpCost
Energy lost opportunity cost in monetary units.
BilateralTranClearing
Bilateral transaction clearing results for a given settlement period.
rpClearedMW
dpClearedMW
PnodeClearing
Pricing node clearing results posted for a given settlement period.
costLMP
Cost component of Locational Marginal Pricing (LMP) in monetary units per MW.
lossLMP
Loss component of Location Marginal Price (LMP) in monetary units per MW.
congestLMP
Congestion component of Location Marginal Price (LMP) in monetary units per MW.
MarketCaseClearing
Market case clearing results are posted for a given settlement period.
caseType
Settlement period:'DA - Bid-in''DA - Reliability''DA - Amp1''DA - Amp2''RT - Ex-Ante''RT - Ex-Post''RT - Amp1''RT - Amp2'
postedDate
Bid clearing results posted time and date.
modifiedDate
Last time and date clearing results were manually modified.
AncillaryServiceClearing
Ancillary services clearing results are posted for a given settlement period.
Requirement type:'En' - Energy'Ru' - Regulation Up'Rd' - Regulation Dn'Sr' - Spinning Reserve'Nr' - Non-Spinning Reserve'Or' - Operating Reserve
mcp
Market clearing price (MCP) in monetary units.
SecurityConstraintsClearing
Binding security constrained clearing results posted for a given settlement period.
mwLimit
mwFlow
shadowPrice
RTO
Participation
Participation level of a given Pnode in a given AggregatePnode.
factor
Used to calculate 'participation' of Pnode in an AggregatePnode. For example, for regulation region this factor is 1 and total sum of all factors for a specific regulation region does not have to be 1. For pricing zone the total sum of all factors has to be 1.
SystemRequirements
Load forecasts and ancillary service requirements for a market.
reqType
reqMW
MarketOperation
timeIntervalLength
rampEnergy
rampReg
rampSpinRes
Ramping time interval for spinning reserve.
rampNonSpinRes
Ramping time interval for non-spinning reserve.
localTimeZone
dst
True if daylight savings time (DST) is in effect.
start
end
LossPenaltyFactor
Loss penalty factor applied to a ConnectivityNode for a given time interval.
lossFactor
SecurityConstraints
Typical for regional transmission operators (RTOs), these constraints include transmission as well as generation group constraints identified in both base case and critical contingency cases.
minMW
Minimum MW limit (only for transmission constraints).
maxMW
actualMW
Actual branch or group of branches MW flow (only for transmission constraints)
SecurityConstraintsLinear
Typically provided by RTO systems, constraints identified in both base case and critical contingency cases have to be transferred.
shiftFactor
Shift factor between transmission constraint and network bus (can be a hub)
resourceMW
Actual MW output of resources connected to network bus.
UnitInitialConditions
Resource status at the end of a given clearing period.
resourceStatus
Resource status at the end of previous clearing period:0 - off-line1 - on-line production2 - in shutdown process3 - in startup process
timeInStatus
Time in market trading intervals the resource is in the state as of the end of the previous clearing period.
cumStatusChanges
Cumulative number of status changes of the resource.
Resource MW output at the end of previous clearing period.
cumEnergy
Cumulative energy production over trading period.
MarketFactors
Aggregation of market information relative for a specific time interval.
timeInterval
The start of the time interval for which requirement is defined.
ResourceReserves
Description of various types of reserves associated with resources.
ConductingEquipment has 1 or 2 terminals that may be connected to other ConductingEquipment terminals via ConnectivityNodes
Terminals
MemberOf_SubControlArea
A SubControlArea may contain one or more Substations. The association is used in the naming hierarchy.
Contain_Substations
The point data values that define a curve
CurveScheduleDatas
CurveScheduleFormula
Used to specify that voltages in the CIM are given a value existing in the collection.
The hydro pump has a pumping schedule over time, indicating when pumping is to occur.
Drives_HydroPump
The synchronous machine drives the turbine which moves the water from a low elevation to a higher elevation. The direction of machine rotation for pumping may or may not be the same as for generating.
DrivenBy_SynchronousMachine
A hydro generating unit has an efficiency curve
HydroGeneratingEfficiencyCurves
A hydro generating unit has a penstock loss curve
A hydro generating unit has a tailbay loss curve
Contain_HydroGeneratingUnits
The hydro generating unit belongs to a hydro power plant
MemberOf_HydroPowerPlant
Contain_HydroPumps
The hydro pump may be a member of a pumped storage plant or a pump for distributing water
Generators discharge water to or pumps are supplied water from a downstream reservoir
HydroPowerPlants
GenSourcePumpDischarge
Generators are supplied water from or pumps discharge water to an upstream reservoir
UpstreamFrom
A reservoir may have a level versus volume relationship.
A reservoir may have a water level target schedule.
A reservoir may have a 'natural' inflow forecast.
SpillsInto
A reservoir may spill into a downstream reservoir
SpillsFrom
A fuel allocation schedule must have a fossil fuel
The unit's startup model may have a startup ignition fuel curve
The unit's startup model may have a startup main fuel curve
The unit's startup model may have a startup ramp curve
A thermal generating unit may have one or more emission allowance accounts
EmmissionAccounts
A thermal generating unit may have one or more emission curves
EmissionCurves
A thermal generating unit may have one or more fossil fuels
FossilFuels
A thermal generating unit may have one or more fuel allocation schedules
FuelAllocationSchedules
A thermal generating unit may have a heat input curve
A thermal generating unit may have a heat rate curve
A thermal generating unit may have an incremental heat rate curve
A thermal generating unit may have a shutdown curve
A thermal generating unit may have a startup model
Contain_AirCompressor
An air compressor may be a member of a compressed air energy storage plant
MemberOf_CAESPlant
A generating unit may have one or more cost curves, depending upon fuel mixture and fuel cost.
GenUnitOpCostCurves
A generating unit may have an operating schedule, indicating the planned operation of the unit
A generating unit may have a gross MW to net MW curve, describing the losses and auxiliary power requirements of the unit
GrossToNetMWCurves
Contain_ThermalGeneratingUnit
A thermal generating unit may be a member of a compressed air energy storage plant
Contain_ThermalGeneratingUnits
A thermal generating unit may be a member of a cogeneration plant
MembmerOf_CogenerationPlant
A thermal generating unit may be a member of a combined cycle plant
MemberOf_CombinedCyclePlant
A cogeneration plant has a steam sendout schedule
A GeneratingUnit injects energy into a SubControlArea.
GeneratingUnits
Contains_SynchronousMachines
A synchronous machine may operate as a generator and as such becomes a member of a generating unit
MemberOf_GeneratingUnit
CombustionTurbines
A combustion turbine may have a heat recovery boiler for making steam
A combustion turbine may have a MW versus ambient temperature relationship
SteamTurbines
Steam turbines may have steam supplied by a steam supply
SteamSupplys
Drives_AirCompressor
A CAES air compressor is driven by combustion turbine
DrivenBy_CombustionTurbine
An energy consumer may have one or more load demand models
LoadDemandModels
An energy consumer may have a non-conforming load schedule
NonConformLoadSchedules
EnergyConsumers
Consumers may be assigned to a load area.
An energy consumer is assigned to a power cut zone
A load area can have one or more area loss curves
AreaLossCurves
A load area can have one or more area load curves
AreaLoadCurves
A load model may be classified by the day type
A system load model may be classified as seasonal
Load demand models can be based on seasons
BasisFor
Load demand models can be based on day type
Substations
Measurements
The measurement associated with the Type
One or more measurements may be associated with a terminal in the network
MemberOf_Measurement
A measurement is represented by one or more measurement values.
Contain_MeasurementValues
A MeasurementValue has a MeasurementValueQuality associated with it.
Values
The ValueToAlias mappings included in the set
The ValueAliasSet having the ValueToAlias mappings
The ValueAliasSet used for translation of a MeasurementValue.value to a name
The Measurements using the set for translation
LimitSets
A measurement may have zero or more limit ranges defined for it.
Limits
The Limits used for supervision. The name of each Limit shall reflect their ordering, e.g. HighAlarm, HighWarning, LowWarning, LowAlarm etc.
MeasuredBy_Measurement
The Measurement variable used for control
ControlledBy_Control
The Control variable associated with the Measurement
MeasurementValues
The MeasurementValues updated by the source
A reference to the type of source that updates the MeasurementValue, e.g. SCADA, CCLink, manual, etc. User conventions for the names of sources are contained in the introduction to IEC 61970-301.
The ValueAliasSet used for translation of a Control value to a name.
Controls
The Controls using the set for translation
Contains_Measurements
The Measurements that are included in the naming hierarchy where the PSR is the containing object
MemberOf_PSR
The PowerSystemResource that contains the Measurement in the naming hierarchy
ControlledBy_RegulatingCondEq
An OutageSchedule may operate many switches.
SwitchingOperations
Switches
A switch may be operated by many schedules.
PSR
A power system resource may have an outage schedule
Conducting equipment may have multiple clearance tags for authorized field work
ClearanceTags
ConductingEquipments
Protection equipment may be used to protect specific Conducting Equipment. Multiple equipment may be protected or monitored by multiple protection equipment.
ProtectionEquipments
Operates_Breakers
Circuit breakers may be operated by protection relays.
OperatedBy_ProtectionEquipments
A breaker may have zero or more automatic reclosures after a trip occurs.
RecloseSequences
Several ConnectivityNode(s) may combine together to form a single TopologicalNode, depending on the current state of the network.
ConnectivityNodes
A topological node belongs to a topological island
TopologicalNodes
Terminals interconnect with zero impedance at a node. Measurements on a node apply to all of its terminals.
MemberOf_EquipmentContainer
Conductors
Sections of conductor are physically described by a conductor type
Contains_ACLineSegments
A line may be made up of AC line segments
MemberOf_Line
Contains_DCLineSegments
A line may be made up of DC line segments
Drives_SynchronousMachines
A synchronous machine that is operating as a generator must be driven by a prime mover of some kind
DrivenBy_PrimeMovers
MemberOf_PowerTransformer
Contains_TransformerWindings
A transformer winding may have tap changers, separately for voltage and phase angle
TapChangers
From_WindingTests
The winding from which the test was conducted
From_TransformerWinding
To_TransformeWindings
The winding to which the test was conducted
To_WindingTest
A ConductorType is made up of wires that can be configured in several ways.
WireArrangements
A WireType is mounted at a specified place in a WireArrangement.
A VoltageControlZone is controlled by a designated BusbarSection.
VoltageControlZones
A VoltageControlZone may have a voltage regulation schedule.
RegulatingCondEqs
A type of conducting equipment that may be used to regulate a network measurement, typically voltage.
A regulating class may have a voltage regulation schedule.
An LTC may regulate a specific measurement from the network, typically voltage. A phase shifter would typically be used to regulate a real power (MW) flow measurement. An LTC with significant phase shift characteristics could be used to regulate MW flow instead of voltage.
Contains_VoltageLevels
The association is used in the naming hierarchy.
MemberOf_Substation
Contains_Bays
MemberOf_VoltageLevel
Contains_Equipments
SynchronousMachines
MVArCapabilityCurves
Contains_CompositeSwitches
OperatedBy_GenerationProvider
A GenerationProvider operates one or more GeneratingUnits.
ControlledBy
ProvidedBy
Sells
A TransmissionProvider sells the right to transmit energy across the wires in a ServiceReservation.
SoldBy
Holds
A Marketer holds title to a ServiceReservation.
HeldBy
LocationFor
A transmission product is located on a transmission path.
LocatedOn
ContractFor
AncillaryServices are sold through a contract which offers a particular OpenAccessProduct.
ProvidedBy_AncillaryService
TransContractFor
A TransmissionService is sold according to the terms of a particular OpenAccessProduct agreement.
ProvidedBy_TransmissionService
Offering
A transmission service is offered on a transmission path.
OfferedOn
HasA_CustomerConsumer
A CustomerConsumer may have one or more ServicePoints.
Offers
The combination of a TransmissionProduct on a TransmissionPath is a TransmissionService, for which the TransmissionProvider must post one or two ATC's (AvailableTransmissionCapacity - Amount of possible flow by direction).
OfferedBy
A TransmissionProvider offers a TransmissionProduct.
TransmissionProducts
A TransmissionProvider offers AncillaryServices. One type of AncillaryServices is a shipping and handling fee to manage the services purchased, another is the 'reactive support - measured in MVAr's' used to control the voltage on the transmission system. This is the amount needed to support the path or amount necessary to maintain the proper voltage at a ServicePoint.
ServiceOf
HasA_GenerationProvider
A GenerationProvider has one or more ServicePoints where energy is injected into the network.
For
Sale of ancillary services provided by ControlAreaOperators.
RegisteredBy
A TransmissionProvider registers one or more ServicePoints.
Registers
Resells
A ServiceReservation may be resold by a Marketer.
ResoldBy
Organisations
A control area has one or more area reserve specifications
HostControlAreas
A control area can have one or more net inadvertent interchange accounts
InadvertentAccounts
Receive_HostControlArea
A control area can receive dynamic schedules from other control areas
Receive_DynamicSchedules
Send_HostControlArea
A control area can send dynamic schedules to other control areas
Send_DynamicSchedules
Export_EnergyTransactions
Energy is transferred between interchange areas
Export_SubControlArea
Import_EnergyTransactions
Import_SubControlArea
SubControlAreas
The interchange area may operate as a control area
MemberOf
A transmission path's service point is part of an interchange area
PartOf
HasAPOD_
A transmission path has a 'point-of-delivery' service point
DeliveryPointFor
HasAPOR_
A transmission path has a 'point-of-receipt' service point
PointOfReceiptFor
The 'Source' for an EnergyTransaction is an EnergyProduct which is injected into a ControlArea.
EnergyTransactions
TitleHeldBy_Marketer
A Marketer holds title to an EnergyProduct.
HoldsTitleTo_EnergyProducts
An EnergyTransaction must have at least one EnergyProfile.
EnergyProfiles
An EnergyTransaction may be curtailed by any of the participating entities.
CurtailmentProfiles
An EnergyTransaction may have a LossProfile.
LossProfiles
ScheduleFor
A transmission schedule posts the available transmission capacity for a transmission line.
ScheduledBy
InjectsEnergyInto
An EnergyProduct injects energy into a service point.
InjectionPointFor
ResoldBy_Marketer
Resells_EnergyProduct
SideA_SubControlArea
The SubControlArea is on the A side of a collection of metered points which define the SubControlArea's boundary for a ControlAreaOperator or CustomerConsumer.
SideA_TieLines
SideB_SubControlArea
The SubControlArea is on the B side of a collection of metered points which define the SubControlArea's boundary for a ControlAreaOperator or CustomerConsumer.
SideB_TieLines
CAChildOf
A ControlAreaOperator has a collection of tie points that ring the ControlArea, called a TieLine.
ParentOfA
CustChildOf
A ControlAreaOperator or CustomerConsumer may ring their perimeter with metering, which can create a unique SubControlArea at the collection of metering points, called a TieLine.
ParentOfB
A CustomerConsumer may ring its perimeter with metering, which can create a unique SubControlArea at the collection of metering points, called a TieLine.
OfferedAs
A transmission product is offered as a transmission service along a transmission path.
HasLoss_
Part of the LossProfile for an EnergyTransaction may be a loss for a TransmissionProvider.
Lines
A transmission line can be part of a transmission corridor
TransmissionRightOfWays
A transmission right-of-way is a member of a transmission corridor
A TransmissionPath is contained in a TransmissionCorridor.
ContainedIn
A measurement is a data source for dynamic interchange schedules
DynamicSchedules
For_Measurements
A measurement is made on the A side of a tie point
For_TiePoint
By_Measurements
A measurement is made on the B side of a tie point
By_TiePoint
A profile has profile data associated with it.
ProfileDatas
A Reserve type of energy transaction can count towards an area reserve specification.
ReserveEnergyTransaction
TieLines
A dynamic energy transaction can act as a pseudo tie line.
DynamicEnergyTransaction
SideB_HostControlArea
A HostControlArea can have zero or more tie lines.
SideA_HostControlArea
ReservedBy_ServiceReservation
A service reservation reserves a particular transmission service.
Reserves_TransmissionService
A ServiceReservation guarantees a certain AncillaryService.
Reserves_AncillaryServices
SecuredBy
An EnergyTransaction is secured by one or more ServiceReservations. A ServiceReservation may be associated with many EnergyTransactions.
AssocatedWith
DeclaredBy
A transmission provider declares one or more tie points.
Declares
Declare_TiePoint
A tiepoint may be declared as a service point.
Declared_ServicePoint
Contain_RemoteUnits
RTUs may be attached to communication links.
MemberOf_CommunicationLinks
Links to the physical telemetered point associated with this measurement.
MemberOf_RemoteUnit
Contains_RemotePoints
AssetGroupings
PowerSystemResources
Documents
ToAssets
FromAssets
AssetModels
QualificationRequirements
Properites
Ratings
AssetLists
Properties
For.InspectionDataSets
AccordingTo.Schedule
Procedures
GovernsDataFor_Interval
Reads_MeasurementValue
ReadBy_ErpContact
Intervals
CustomerMeters
MeterAssets
AssetRating
AssetProperty
DiagnosisDataSets
TestDataSets
StructureSupports
Secures_Structure
Support_Streetlights
AttachedTo_Pole
Poles
LinearConductor
CustomerAccounts
ErpAddresses
CustomerAgreements
ServiceLocations
CustomerAreement
PricingStructures
ErpReceivables
PowerQualityPricings
Tariffs
CustomerBillings
CustomerLists
Customers
Locations
CoordinatePairs
RightOfWays
LocationGrants
grants.RightOfWays
grantedBy.Organisations
Serves_Site
Sites
Zones
fromLocation
toLocation
recipientOf.RightOfWays
recipient.Organisations
WorkTasks
Contains.Locations
IsPartOf.Location
Parent_Organisation
Child_Organisation
ErpContacts
Vehicles
Tools
SkillCertifications
fromDocuments
toDocuments
Presentations
EquipmentLists
NetworkDataSets
NetworkChangeSets
Previous_NetworkChangeSet
Next.NetworkChangeSet
LoadDataSets
LandBases
MachineCatalogues
ConductorTypes
IsolatedBy_SafetyDocuments
Isolate_EquipmentList
OperationalRestrictions
ScheduleSteps
SafetyDocuments
OutageSteps
OutageRecords
OutageCodes
Crews
AffectedSupply_EquipmentList
OutageNotification
TroubleTickets
OutageSchedules
ErpTelephoneNumbers
ContractorItems
LaborItems
MaterialItems
PropertyUnits
ErpPayables
parent_CostType
child_CostType
WorkCostDetails
MiscCostItems
VehicleItems
Designs
CUTasks
CompatibleUnits
CUGroups
DesignLocations
ErpPurchaseOrders
Projects
parent_Project
sub_Project
Requests
SwitchingSchedules
MaintenanceDataSets
InspectionDataSets
ProcedureValues
Appointments
Parent_CUGroup
Child_CUGroup
CUContractorItems
CULaborItems
CUMaterialItems
CUVehicleItems
RampRateCurves
Bids
StartUpCostCurves
EnergyPriceCurves
EnergyProducts
BilateralTransactions
RTOs
Pnodes
LossPenaltyFactors
AggregatePnodes
Delivery_Pnode
Receipt_Pnode